为 Amazon Chime SDK 会议配置视频编解码器
客户端设备使用视频编解码器在原始视频发送到服务之前对其进行压缩,并在渲染接收到的视频之前对其进行解压缩。
使用适用于 JavaScript 的 Amazon Chime SDK 客户端库时,可以指定发送视频的编解码器首选项。
适用于 iOS 和 Android 的 Amazon Chime SDK 客户端库会根据设备的功能自动为您选择编解码器。
设置视频编解码器首选项
在适用于 JavaScript 的 Amazon Chime SDK 客户端库中,可以为网络摄像头和内容视频指定独立的视频编解码器首选项。
使用 AudioVideoControllerFacade.setVideoCodecSendPreferences
您的首选项以有序数组的形式传递,首先传递您最希望使用的编解码器,最后传递您最不希望使用的编解码器。
当提供多个编解码器首选项时,该服务会自动选择所有会话参与者都可以解码的首选编解码器。
以下示例演示如何为具有 VP8 回退选项的 VP9 设置视频编解码器首选项:
// A meeting session has already been created and stored in `this.meetingSession` this.meetingSession.audioVideo.setVideoCodecSendPreferences( [ VideoCodecCapability.vp9(), VideoCodecCapability.vp8() ] );
以下情况适用于这些首选项:
-
最佳 - 客户端使用 VP9 编解码器对视频进行编码。
-
本地回退 - 如果客户端不支持 VP9 编码,则会转为使用 VP8 编码。如果客户端不支持 VP8 编码,则会转为使用浏览器和服务支持的任何编解码器。
-
远程回退 - 如果会话中的另一个客户端没有 VP9 解码器,则该客户端会转为使用 VP8 编码。
-
本地故障 - 如果客户端不支持 VP9 或 VP8 编码,将不会发送视频。
要设置内容共享首选项,请使用 ContentShareControllerFacade.setContentShareVideoCodecPreferences
以下示例为具有 VP8 回退选项的 VP9 设置内容视频编解码器首选项。
// A meeting session has already been created and stored in `this.meetingSession` this.meetingSession.audioVideo.setContentShareVideoCodecPreferences( [ VideoCodecCapability.vp9(), VideoCodecCapability.vp8() ] );