ZegoAudioAuxDelgate Protocol Reference

Conforms to NSObject
Declared in zego-api-audio-aux-oc.h

Overview

混音音频数据输入回调（可输入媒体次要信息）

– onAuxCallback:dataLen:sampleRate:channelCount:

混音音频数据的输入回调，当开启混音后，用户调用该 API 将混音数据传递给 SDK。

- (void)onAuxCallback:(void *)pData dataLen:(int *)pDataLen sampleRate:(int *)pSampleRate channelCount:(int *)pChannelCount

Parameters

pData

待混音的音频数据
pDataLen

一次传入的音频数据长度；SDK会提供好长度值，用户按照这个长度写入音频数据即可；如果填写的音频数据长度大于等于 pDataLen，则无需更改 pDataLen 的值;如果填写的音频数据长度小于 pDataLen，将 pDataLen 的值更改为0；当音频最后的尾音不足 SDK 提供的长度值时，又需要向 SDK 传入完整的音频数据，可以用静音数据补齐后再传给 SDK。
pSampleRate

混音数据采样率，支持16k、32k、44.1k、48k
pChannelCount

混音数据声道数，支持1、2

Discussion

  • 注意：
  • 1.针对混音数据，目前 SDK 仅支持位深为 16bit，16k、32k、44.1k、48k 采样率，单声道或者双声道的 PCM 音频数据格式。
  • 2.用户根据实际的 PCM 音频填写采样率及声道数。
  • 3.为确保混音效果，请不要在此 API 中执行耗时操作。

Declared In

zego-api-audio-aux-oc.h

– onAuxCallback:dataLen:sampleRate:channelCount:sideInfo:sideInfoLen:packet:

混音音频数据的输入回调，当开启混音后，用户调用该 API 将混音数据传递给 SDK。

- (void)onAuxCallback:(void *)pData dataLen:(int *)pDataLen sampleRate:(int *)pSampleRate channelCount:(int *)pChannelCount sideInfo:(unsigned char *)pSideInfo sideInfoLen:(int *)pSideInfoLength packet:(bool *)pPacket

Parameters

pData

待混音的音频数据
pDataLen

一次传入的音频数据长度；SDK会提供好长度值，用户按照这个长度写入音频数据即可；如果填写的音频数据长度大于等于 pDataLen，则无需更改 pDataLen 的值;如果填写的音频数据长度小于 pDataLen，将 pDataLen 的值更改为0；当音频最后的尾音不足 SDK 提供的长度值时，又需要向 SDK 传入完整的音频数据，可以用静音数据补齐后再传给 SDK。
pSampleRate

混音数据采样率，支持16k、32k、44.1k、48k
pChannelCount

混音数据声道数，支持1、2
pSideInfo

媒体次要信息数据缓冲区地址,若不需要带媒体次要信息
pSideInfoLength

媒体次要信息数据缓冲区长度
bPacket

媒体次要信息数据是否外部已经打包好包头，YES 表示采用外部打包的包头， NO 表示采用 ZEGO 内部打包的包头。

Discussion

  • 注意：
    1. 针对混音数据，目前 SDK 仅支持位深为 16bit，16k、32k、44.1k、48k 采样率，单声道或者双声道的 PCM 音频数据格式。
  • 2.用户根据实际的 PCM 音频填写采样率及声道数。
  • 3.为确保混音效果，请不要在此 API 中执行耗时操作。
  • 4.发送媒体次要信息前需要调用 [ZegoMediaSideInfo -setMediaSideFlags:onlyAudioPublish:mediaInfoType:seiSendType:channelIndex:] 开启媒体次要信息传输功能。
  • 5.此接口带媒体次要信息时必须要带有混音音频数据(不能只有媒体次要信息)才能发送媒体次要信息，如果不带混音音频数据则会丢掉媒体次要信息。

See Also

Declared In

zego-api-audio-aux-oc.h