enableAlphaChannelVideoEncode method

FutureOr<int> enableAlphaChannelVideoEncode(
  1. AlphaLayout alphaLayout
)

@valid since 3.58 @detail api @hiddensdk(audiosdk) @author zhuhongshuyu @brief 开启自定义采集视频帧的 Alpha 通道编码功能。
适用于需要分离推流端视频主体与背景,且在拉流端可自定义渲染背景的场景。 @param alphaLayout 分离后的 Alpha 通道相对于 RGB 通道信息的排列位置。当前仅支持 AlphaLayout.TOP,即置于 RGB 通道信息上方。 @return 方法调用结果:
- 0: 调用成功。 - < 0 : 调用失败。查看 ReturnStatus{@link #ReturnStatus} 获得更多错误说明。 @note - 该接口仅作用于自定义采集的、并且使用 RGBA 色彩模型的视频帧,包括 VideoPixelFormat.TEXTURE_2D、VideoPixelFormat.TEXTURE_OES、VideoPixelFormat.RGBA。 - 该接口须在发布视频流之前调用。 - 调用本接口开启 Alpha 通道编码后,你需调用 pushExternalVideoFrame{@link #RTCEngine#pushExternalVideoFrame} 把自定义采集的视频帧推送至 RTC SDK。若推送了不支持的视频帧格式,则调用 pushExternalVideoFrame{@link #RTCEngine#pushExternalVideoFrame} 时会返回错误码 ReturnStatus.RETURN_STATUS_PARAMETER_ERR。

Implementation

FutureOr<int> enableAlphaChannelVideoEncode(AlphaLayout alphaLayout) async {
  return await nativeCall(
      'enableAlphaChannelVideoEncode', [alphaLayout.$value]);
}