自定义音频采集和渲染

  • HarmonyOS

更新时间不可用

createCustomAudioTrack

创建一个自定义音频采集轨道。

TypeScript
public abstract createCustomAudioTrack(trackType: Constants.AudioTrackType, config: AudioTrackConfig): number;

详情

注意: 该方法需要在加入频道前调用。

如需在频道中发布自定义采集音频,可参考以下步骤:

  1. 调用该方法创建音频轨道并获得音频轨道 ID。
  2. 调用 joinChannelWithOptions 加入频道时,将 ChannelMediaOptions 中的 publishCustomAudioTrackId 设置为你想要发布的音频轨道 ID,并将 publishCustomAudioTrack 设置为 true。
  3. 调用 将 trackId 指定为步骤 2 中指定的音频轨道 ID,即可实现在频道内发布对应的自定义音频源。

参数

参数名描述
trackType

自定义音频轨道类型。详见 AudioTrackType。

注意: 如指定 DIRECT,则必须在调用 joinChannelWithOptions 加入频道时,将 ChannelMediaOptions 中的 publishMicrophoneTrack 设为 false,否则加入频道失败并返回错误码 -2.

config

自定义音频轨道配置。详见 AudioTrackConfig。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

  • 方法调用成功,返回音频轨道 ID 作为该音频轨道的唯一标识。
  • 方法调用失败,返回 0xffffffff。详见错误码了解详情和解决建议。

destroyCustomAudioTrack

销毁指定的音频轨道。

TypeScript
public abstract destroyCustomAudioTrack(trackId: number): number;

详情

参数

参数名描述
trackId

调用 createCustomAudioTrack 方法返回的自定义音频轨道 ID。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。