播放透明礼物特效

功能简介

在语聊房和直播等场景中，礼物是主播与观众互动的重要环节。精致的礼物效果，可以增强互动感，提升观看体验。随着行业的蓬勃发展，礼物效果也从静态到动态、从不透明到透明逐步进化。

通过播放 MP4 的礼物视频来实现动态礼物效果，是比较常见的方式。由于 MP4 不支持 Alpha 通道，在全屏播放礼物特效时，会挡住直播间的内容，从而影响用户体验。因此 ZEGO Express SDK 媒体播放器提供透明渲染能力，可以实现播放透明动态礼物的功能。

ZEGO Express SDK 媒体播放器提供 RGB 通道与 Alpha 通道分离播放 MP4 素材（RGB 与 Alpha 拼接后的 MP4 素材）的功能，实现播放透明礼物的动态效果，即播放礼物特效时，不会挡住直播间内容，大大提升用户体验。

功能优势

• 开发成本低

  开发者不需要学习复杂的动画实现方案，只需要使用设计师处理好的素材，即可实现播放透明礼物特效，提升开发效率和效果。

• 动画还原度高

  帮助设计师实现输出素材所见即所得，即设计师在设计动效时，无需担心开发人员使用的技术栈能否还原动效复杂的 3D 效果、描边、粒子效果等。

• 兼容性好

  规避 Lottie、Cocos2d-X 等半透明动效实现方式复杂、性能不高，以及部分机型的兼容问题较大、后期维护难度较高的问题。

实现原理

如下图所示，图中上半部分为一段进行了 Alpha 通道分离的素材的部分像素点，左侧使用 RGB 通道存储了礼物素材的 RGB 通道的信息，右侧使用 RGB 通道存储了礼物素材的 Alpha 通道的信息。

客户端播放时，会将右侧的视频的 R 通道提取出来，作为左侧对应像素点的 Alpha 通道的值。

渲染时，将 Alpha 通道的值除以 255，进行归一化处理，得到 0 ~ 1 之间的 Alpha 取值，最后根据 RGBA 值将每个像素点渲染到屏幕上，实现半透明效果。

前提条件

在使用媒体播放器播放 MP4 动态效果，即实现播放透明礼物特效之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

实现流程

1 输出素材

以在 AE 软件中输出素材为例。

1. 在 AE 中正常制作带透明效果的视频，并分别输出 RGB 及 Alpha 通道视频。
   • 输出 RGB 通道的视频。
     
   • 输出 Alpha 通道的视频。
     

2. 在 AE 中，将输出的 RGB 及 Alpha 通道视频拼接为一个视频。

   ZEGO 媒体播放器支持以下四种拼接方式，拼接出的视频越接近正方形，性能越好。开发者可以根据源素材的比例，选择合适的拼接方式：

   • Alpha 通道在下方。
     
   • Alpha 通道在左侧。
     
   • Alpha 通道在右侧。
     
   • Alpha 通道在右上方，Alpha 通道仅支持 0.5x 的缩放倍率。
     

2 创建媒体播放器

调用 createMediaPlayer 创建媒体播放器。

ZegoExpressEngine.instance().createMediaPlayer().then((player) => {
  this.mediaPlayer = player;
});

3 加载素材

调用 createMediaPlayer 创建媒体播放器后，通过 loadResourceWithConfig 接口，通过文件路径或二进制内存数据，播放拼接后的特效素材。

let resource = new ZegoMediaPlayerResource()
let path = "/static/source1_complex_rl.mp4"
resource.loadType = ZegoMultimediaLoadType.FilePath //加载方式选择文件路径加载
resource.filePath = plus.io.convertLocalFileSystemURL(path) //文件路径
resource.alphaLayout = ZegoAlphaLayoutType.Left //根据实际资源选择 Alpha 通道布局
this.mediaPlayer.loadResourceWithConfig(resource).then((ret) => {
    console.log("load resource error: " + ret.errorCode)
});

// 加载资源文件并返回二进制数据
let path = "/static/source1_complex_rl.mp4"
plus.io.resolveLocalFileSystemURL(path, function(entry) {  
    entry.file(function(file) {  
        var fileReader = new plus.io.FileReader()  
        fileReader.onload = function(data) {  
            let base64 = data.result.split(',')[1] // 获取base64字符串
            const arrayBuffer = uni.base64ToArrayBuffer(base64) // 转换为arrayBuffer 格式
            const int8array = new Uint8Array(arrayBuffer)

            let resource = new ZegoMediaPlayerResource()
            resource.loadType = ZegoMultimediaLoadType.Memory // 加载方式选择二进制数据加载
            resource.alphaLayout = ZegoAlphaLayoutType.Left // 根据实际资源选择 Alpha 通道布局
            resource.memory = int8array

            this.mediaPlayer.loadResourceWithConfig(resource).then((ret) => {
              console.log("load resource error: " + ret.errorCode)
            });
        }  
        fileReader.readAsDataURL(file)  
    }, function(error) {  
        console.log("load resource error: " + JSON.stringify(error));  
    })  
}, function(error) {  
    console.log("load resource error: " + JSON.stringify(error))
})               

4 播放素材

在调用 loadResourceWithConfig 加载文件成功后，可调用 start、pause、resume、stop 来启停播放。一旦播放器的内部状态改变，ZegoMediaPlayer 的 mediaPlayerStateUpdate 回调将会被触发。

用户也可通过调用 getCurrentState 随时获取播放器的当前状态。

如果 enableRepeat 设置为 YES，则播放器会在播放完文件后自动重播。

// 开始播放，播放之前需要先调用接口加载媒体文件
this.mediaPlayer.start();
// 暂停
this.mediaPlayer.pause();
// 恢复
this.mediaPlayer.resume();
// 停止
this.mediaPlayer.stop();

5 播放器透明视图控制

当播放视频资源时，使用 <zego-mediaplayer-view> 标签，并设置 alphaBlend 参数为 true，开启播放器透明效果，然后调用 setPlayerView 接口设置视频的显示视图。

<template>
    <zego-mediaplayer-view :playerID="playerID" :alphaBlend="true" style="height: 260.38rpx"></zego-mediaplayer-view>
</template>

//JS 部分:
let mediaPlayer = await ZegoExpressEngine.instance().createMediaPlayer();
this.playerID = mediaPlayer.getIndex();
mediaPlayer.setPlayerView(this.playerID);

6 销毁媒体播放器

媒体播放器使用完毕后，需要及时调用 destroyMediaPlayer 接口销毁播放器实例变量，释放占用的资源。

// 销毁媒体播放器 
ZegoExpressEngine.instance().destroyMediaPlayer(this.mediaPlayer)