参数变更

onPublicStreamSEIMessageReceived

参数 sourceType 的类型由 SEIMessageSourceType 变更为 DataMessageSourceType
拆分为：

• onPublicStreamSEIMessageReceived：接收客户端插入的 SEI 消息。
• onPublicStreamDataMessageReceived：接收服务端插入的 SEI 消息和其他数据信息，例如音量信息。

枚举值变更

PublicStreamErrorCode

新增枚举值：

• kPublicStreamErrorCodePullNoPushStream = 1300

名称变更：

• kPublicStreamOK = 0 更新为 kPublicStreamErrorCodeOK = 0

• kPublicStreamPushInvalidParam = 1191 更新为 kPublicStreamErrorCodePushInvalidParam = 119

• kPublicStreamPushInvalidStatus = 1192 更新为 kPublicStreamErrorCodePushInvalidStatus = 1192

• kPublicStreamPushInternalError = 1193 更新为 kPublicStreamErrorCodePushInternalError = 1193

• kPublicStreamPushFailed = 1195 更新为 kPublicStreamErrorCodePushFailed = 1195

• kPublicStreamPushTimeout = 1196 更新为 kPublicStreamErrorCodePushTimeout = 1196

ErrorCode

新增枚举值 ByteRTCErrorCodeJoinRoomRoomForbidden=-1025 和 ByteRTCErrorCodeJoinRoomUserForbidden=-1026。
当服务端在指定房间封禁指定用户，而此用户加入房间失败，或从房间中被踢出时收到。

拆分

视频管理

virtual int registerFaceDetectionObserver(IFaceDetectionObserver* observer, int interval_ms) = 0;

• virtual int enableFaceDetection(IFaceDetectionObserver* observer, unsigned int interval_ms, const char* faceModelPath) = 0;
• virtual int disableFaceDetection() = 0;

解除人脸识别与视频特效之间的耦合，提升接口易用性。

行为变更

屏幕共享

• setVideoSourceType: 屏幕流默认为外部源
• setScreenAudioSourceType: 当前设置为内部源时，且已开启了采集，调用该接口切换为外部源时，不会停止内部采集
• startScreenVideoCapture: 当前为外部源时，调用本接口将自动切换为内部源，并开启采集
• stopScreenVideoCapture: 当前为外部源时，调用本接口将关闭外部采集

• setVideoSourceType: 屏幕流默认为内部源
• setScreenAudioSourceType: 当前设置为内部源时，且已开启了采集，调用该接口切换为外部源时，自动停止内部采集
• startScreenVideoCapture: 当前为外部源时，调用本接口失败，并触发 `onVideoDeviceWarning`
• stopScreenVideoCapture: 当前为外部源时，调用本接口失败，并触发 `onVideoDeviceWarning`

优化屏幕共享接口的行为

名称和参数变更

音视频处理

• virtual int checkLicense(void* androidContext, void* jnienv, const char* licensePath) = 0;
• virtual void setAlgoModelPath(const char* modelPath) = 0;

virtual int initCVResource(const char* license_file_path, const char* algo_model_dir) = 0;

统一返回值

virtual int enableEffect(bool enabled) = 0;

• virtual int enableVideoEffect() = 0;
• virtual int disableVideoEffect() = 0;

多个模块

返回值类型变化，例如：

• 旧方法——virtual void updateToken(const char* token) = 0;

• 新方法——virtual int updateToken(const char* token) = 0;

该版本中含此变更的方法包括：

updateToken (返回值 void—>int)

setRemoteVideoConfig (返回值 void—>int)

subscribeStream (返回值 void—>int)

unsubscribeStream (返回值 void—>int)

subscribeScreen (返回值 void—>int)

unsubscribeScreen (返回值 void—>int)

pushExternalAudioFrame (返回值 bool—>int)

pullExternalAudioFrame (返回值 bool—>int)

pushExternalVideoFrame (返回值 bool—>int)

setRemoteAudioPlaybackVolume (返回值 void—>int)

pushExternalEncodedVideoFrame (返回值 bool—>int)

setPublicStreamVideoSink (返回值 void—>int)

enableSimulcastMode (返回值 int—>void)

setPublishFallbackOption (返回值 int—>void)

setSubscribeFallbackOption (返回值 int—>void)

ContentHint

废弃屏幕共享内部采集的变量content_hint。可通过 VideoEncodePreference设置视频流编码偏好，通过ScreenVideoEncodePreference设置屏幕流编码偏好。

AudioDeviceInfo

增加成员变量 device_short_name[MAX_DEVICE_ID_LENGTH]

枚举值名称变更

VideoSourceType

枚举值名称增加前缀 k，更改后的枚举值如下：
enum VideoSourceType {
kVideoSourceTypeExternal = 0,
kVideoSourceTypeInternal = 1,
kVideoSourceTypeEncodedWithAutoSimulcast = 2,
kVideoSourceTypeEncodedWithoutAutoSimulcast = 3,
};