# 实时共赏影音 (/zh-CN/solutions/meta-world/build/share-audio-video) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). <_PlatformTabsGroup> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" /> 本文介绍如何实现实时共赏影音功能。 实时共赏影音功能指多用户在虚拟环境中共同观看电影、聆听音乐和 K 歌。不同用户看到视频、听到音乐几乎是同时的,用户间的互动也几乎没有延迟。虚拟环境可以设置为电影院等娱乐场所,用户可以随时暂停视频,与其他用户进行实时交流互动,从而更好地体验观影、听歌、唱歌的乐趣。实时共赏影音功能可以增加元语聊场景的多样性,为在线互动提供更真实的体验。 ![共赏影音示意](https://web-cdn.agora.io/docs-files/1679563308898) ## 技术原理 [#技术原理] 实时共赏影音的技术原理如下图所示: ![实时共赏影音](https://web-cdn.agora.io/docs-portal/img/meta-world/share-audio-video.png) 在一起看电影、听音乐的功能实现中,主播通过媒体播放器控制音视频的播放,并将从媒体播放器获取的视频原始数据推送至 Unity 场景。同时,主播发布麦克风采集的音频和播放器的音乐,受众可以订阅这些音频。主播和受众通过数据流进行播放进度和播放 URL 的信息传递。受众控制媒体播放器对齐主播的播放进度,并把播放器播放的视频原始帧推送至 Unity 场景。 在一起 K 歌的功能实现中,你还需要添加在当前平台展示 K 歌房的玩法,并通过一起看电影的逻辑进行视频的同步。K 歌的功能实现详见 [K 歌房](/zh-CN/solutions/online-ktv)。 ## 示例项目 [#示例项目] 声网在 GitHub 上提供开源 [Agora-MetaWorld](https://github.com/AgoraIO-Community/Agora-MetaWorld/tree/dev_metasdk1.0) 示例项目供你参考。 如果你还需了解 Unity 部分的工程文件和功能指南,请联系 sales@shengwang.cn 获取。 ## 前提条件 [#前提条件] 实现该进阶功能前,请确保你已实现基础的元语聊或元直播功能,如创建 Meta 服务、获取并下载场景资源、创建场景、设置虚拟形象的信息并进入场景。详见[基础功能](/zh-CN/solutions/meta-world/build/metachat)。 ## 实现步骤 [#实现步骤] 下图展示 API 调用时序: ![实时共赏影音 API 时序图](https://web-cdn.agora.io/docs-portal/img/meta-world/share-audio-video-android.svg) ### 1 推送视频 [#1-推送视频] 调用 [`enableVideoDisplay`](/zh-CN/solutions/meta-world/reference/meta-api#enablevideodisplay) 开启元宇宙中的视频显示屏,再通过 [`pushVideoFrameToDisplay`](/zh-CN/solutions/meta-world/reference/meta-api#pushvideoframetodisplay) 将你从媒体播放器 [`onFrame`](/zh-CN/api-reference/rtc/android/play/mediaplayer/mediaplayer-observer#onframe) 回调得到的视频帧推送至该视频显示屏。 ```java // 开启视频显示屏 // "1" 为指定的 displayID metaScene.enableVideoDisplay("1", true); // 将媒体播放器 onFrame 回调视频帧推送至指定的视频显示屏上 metaScene.pushVideoFrameToDisplay("1", frame); ``` ### 2 同步视频播放进度 [#2-同步视频播放进度] 为了同步主播和观众的视频播放进度,主播调用 [`sendStreamMessage`](/zh-CN/api-reference/rtc/android/metadata/datastream#api_irtcengine_sendstreammessage) 发布携带播放进度的数据流,观众通过 [`onStreamMessage`](/zh-CN/api-reference/rtc/android/metadata/datastream#callback_irtcengineeventhandler_onstreammessage) 接收数据流,解析出播放进度。 ```java public abstract int sendStreamMessage(int streamId, byte[] message); ``` <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" /> 本文介绍如何实现实时共赏影音功能。 实时共赏影音功能指多用户在虚拟环境中共同观看电影、聆听音乐和 K 歌。不同用户看到视频、听到音乐几乎是同时的,用户间的互动也几乎没有延迟。虚拟环境可以设置为电影院等娱乐场所,用户可以随时暂停视频,与其他用户进行实时交流互动,从而更好地体验观影、听歌、唱歌的乐趣。实时共赏影音功能可以增加元语聊场景的多样性,为在线互动提供更真实的体验。 ![共赏影音示意](https://web-cdn.agora.io/docs-files/1679563308898) ## 技术原理 [#技术原理-1] 实时共赏影音的技术原理如下图所示: ![实时共赏影音](https://web-cdn.agora.io/docs-portal/img/meta-world/share-audio-video.png) 在一起看电影、听音乐的功能实现中,主播通过媒体播放器控制音视频的播放,并将从媒体播放器获取的视频原始数据推送至 Unity 场景。同时,主播发布麦克风采集的音频和播放器的音乐,受众可以订阅这些音频。主播和受众通过数据流进行播放进度和播放 URL 的信息传递。受众控制媒体播放器对齐主播的播放进度,并把播放器播放的视频原始帧推送至 Unity 场景。 在一起 K 歌的功能实现中,你还需要添加在当前平台展示 K 歌房的玩法,并通过一起看电影的逻辑进行视频的同步。K 歌的功能实现详见 [K 歌房](/zh-CN/solutions/online-ktv)。 ## 示例项目 [#示例项目-1] 声网在 GitHub 上提供开源 [Agora-MetaWorld](https://github.com/AgoraIO-Community/Agora-MetaWorld/tree/dev_metasdk1.0) 示例项目供你参考。 如果你还需了解 Unity 部分的工程文件和功能指南,请联系 sales@shengwang.cn 获取。 ## 前提条件 [#前提条件-1] 实现该进阶功能前,请确保你已实现基础的元语聊或元直播功能,如创建 Meta 服务、获取并下载场景资源、创建场景、设置虚拟形象的信息并进入场景。详见[基础功能](/zh-CN/solutions/meta-world/build/metachat)。 ## 实现步骤 [#实现步骤-1] 下图展示 API 调用时序: ![实时共赏影音 API 时序图](https://web-cdn.agora.io/docs-portal/img/meta-world/share-audio-video-ios.svg) ### 1 推送视频 [#1-推送视频-1] 调用 [`enableVideoDisplay`](/zh-CN/solutions/meta-world/reference/meta-api#enablevideodisplay) 开启元宇宙中的视频显示屏,再通过 [`pushVideoFrameToDisplay`](/zh-CN/solutions/meta-world/reference/meta-api#pushvideoframetodisplay) 将你从媒体播放器 [`didReceiveVideoFrame`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-observer#api_agorartcmediaplayervideoframedelegate_didreceivevideoframe) 回调得到的视频帧赋值给 `AgoraVideoFrame` 并推送其至该视频显示屏。 ```swift // 开启视频显示屏 // "1" 为指定的 displayID metaScene?.enableVideoDisplay("1", enable: true) // vf 为待推送的视频帧 let vf = AgoraVideoFrame() // 格式为 I420 vf.format = 1 vf.strideInPixels = Int32(videoFrame.width) vf.height = Int32(videoFrame.height) vf.dataBuf = data // 将视频帧推送至指定的视频显示屏上 metaScene?.pushVideoFrame(toDisplay: "1", frame: vf) ``` ### 2 同步视频播放进度 [#2-同步视频播放进度-1] 为了同步主播和观众的视频播放进度,主播调用 [`sendStreamMessage`](/zh-CN/api-reference/rtc/ios/metadata/datastream#api_irtcengine_sendstreammessage) 发布携带播放进度的数据流,观众通过 [`receiveStreamMessageFromUid`](/zh-CN/api-reference/rtc/ios/metadata/datastream#callback_irtcengineeventhandler_onstreammessage) 接收数据流,解析出播放进度。 ```swift func sendStreamMessage( _ streamId: Int, data: Data ) -> Int ``` <_PlatformProcessedMarker close="true" />