向应用添加空间视频

Jetpack XR SDK 支持在平面上播放立体并排视频。对于立体视频，每个帧都包含左眼图像和右眼图像，以便为观看者提供深度感，也称为立体视觉。

您可以使用用于其他设备规格的 Android 开发的标准媒体 API 在 Android XR 应用上渲染非立体 2D 视频。

使用 Jetpack SceneCore 播放并排视频

对于并排视频，每个立体帧都以两张水平相邻的图片呈现。顶部和底部视频帧垂直相邻排列。

并排视频不是编解码器，而是一种组织立体帧的方式，这意味着它可以采用Android 支持的任何编解码器进行编码。

您可以使用 Media3 Exoplayer 加载并排视频，然后使用新的 SurfaceEntity 进行渲染。如需创建 SurfaceEntity，请调用 SurfaceEntity.create，如以下示例所示。

val stereoSurfaceEntity = SurfaceEntity.create(
    xrSession,
    SurfaceEntity.StereoMode.SIDE_BY_SIDE,
    Pose(Vector3(0.0f, 0.0f, -1.5f)),
    SurfaceEntity.CanvasShape.Quad(1.0f, 1.0f)
)
val videoUri = Uri.Builder()
    .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
    .path("sbs_video.mp4")
    .build()
val mediaItem = MediaItem.fromUri(videoUri)

val exoPlayer = ExoPlayer.Builder(this).build()
exoPlayer.setVideoSurface(stereoSurfaceEntity.getSurface())
exoPlayer.setMediaItem(mediaItem)
exoPlayer.prepare()
exoPlayer.play()SpatialVideo.kt

使用 Jetpack SceneCore 播放 MV-HEVC 视频

MV-HEVC 编解码器标准经过优化，专为立体视频设计，可让您的应用以出色的画质高效播放沉浸式视频。 MV-HEVC 文件包含一个主视频流（通常是左眼视频）和一个包含另一只眼睛的立体视频流。

与并排视频类似，您可以使用 Media3 Exoplayer 加载它，并使用 SurfaceEntity 渲染它。调用 SurfaceEntity.create 时，您需要在 stereoMode 参数中指定 MV-HEVC 文件是左侧还是右侧主文件。

// Create the SurfaceEntity with the StereoMode corresponding to the MV-HEVC content
val stereoSurfaceEntity = SurfaceEntity.create(
    xrSession,
    SurfaceEntity.StereoMode.MULTIVIEW_LEFT_PRIMARY,
    Pose(Vector3(0.0f, 0.0f, -1.5f)),
    SurfaceEntity.CanvasShape.Quad(1.0f, 1.0f)
)
val videoUri = Uri.Builder()
    .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
    .path("mvhevc_video.mp4")
    .build()
val mediaItem = MediaItem.fromUri(videoUri)

val exoPlayer = ExoPlayer.Builder(this).build()
exoPlayer.setVideoSurface(stereoSurfaceEntity.getSurface())
exoPlayer.setMediaItem(mediaItem)
exoPlayer.prepare()
exoPlayer.play()SpatialVideo.kt

使用 Jetpack SceneCore 播放 180 度视频和 360 度全景视频

SurfaceEntity 支持在半球面表面上播放 180 度视频，在球面表面上播放 360 度视频。radius 参数默认是指相应表面的径向大小（以米为单位）。

以下代码展示了如何设置 SurfaceEntity 以在 180° 半球和 360° 球面上播放。使用这些画布形状时，请利用用户的头部姿势来定位表面，以提供沉浸式体验。

// Set up the surface for playing a 180° video on a hemisphere.
val hemisphereStereoSurfaceEntity =
    SurfaceEntity.create(
        xrSession,
        SurfaceEntity.StereoMode.SIDE_BY_SIDE,
        xrSession.scene.spatialUser.head?.transformPoseTo(
            Pose.Identity,
            xrSession.scene.activitySpace
        )!!,
        SurfaceEntity.CanvasShape.Vr180Hemisphere(1.0f),
    )
// ... and use the surface for playing the media.SpatialVideo.kt

// Set up the surface for playing a 360° video on a sphere.
val sphereStereoSurfaceEntity =
    SurfaceEntity.create(
        xrSession,
        SurfaceEntity.StereoMode.TOP_BOTTOM,
        xrSession.scene.spatialUser.head?.transformPoseTo(
            Pose.Identity,
            xrSession.scene.activitySpace
        )!!,
        SurfaceEntity.CanvasShape.Vr360Sphere(1.0f),
    )
// ... and use the surface for playing the media.SpatialVideo.kt

高级 SurfaceEntity 控制

如需更高级地控制视频和图片渲染，例如应用自定义材质效果，您可以直接使用 SceneCore 库中的 SurfaceEntity。

以下部分介绍了 SurfaceEntity 上提供的一些高级功能。

应用边缘羽化

通过设置 edgeFeather 属性，柔化表面的边缘，使其与环境融为一体。

// Create a SurfaceEntity.
val surfaceEntity = SurfaceEntity.create(
    session = xrSession,
    pose = Pose(Vector3(0.0f, 0.0f, -1.5f))
)

// Feather the edges of the surface.
surfaceEntity.edgeFeather =
    SurfaceEntity.EdgeFeatheringParams.SmoothFeather(0.1f, 0.1f)SpatialVideo.kt

应用 Alpha 蒙版

应用 Alpha 遮罩可创建非矩形 surface 或添加透明度效果。首先，从资源加载 Texture，然后将其分配给 primaryAlphaMaskTexture 属性：

// Create a SurfaceEntity.
val surfaceEntity = SurfaceEntity.create(
    session = xrSession,
    pose = Pose(Vector3(0.0f, 0.0f, -1.5f))
)

// Load the texture in a coroutine scope.
activity.lifecycleScope.launch {
    val alphaMaskTexture =
        Texture.create(
            xrSession,
            Paths.get("textures", "alpha_mask.png"),
            TextureSampler.create()
        )

    // Apply the alpha mask.
    surfaceEntity.primaryAlphaMaskTexture = alphaMaskTexture

    // To remove the mask, set the property to null.
    surfaceEntity.primaryAlphaMaskTexture = null
}SpatialVideo.kt

使用 Jetpack Compose for XR 播放空间视频

如果您有兴趣了解如何使用 Jetpack Compose for XR 播放视频，请了解如何添加用于显示图片或视频内容 Surface。