实时音视频

    • 实时音视频 > API 文档 > iOS >QNMicrophoneAudioTrack

    QNMicrophoneAudioTrack

    最近更新时间: 2022-10-27 15:01:59

    本地音频麦克风 Track 类
    Hierarchy
    Index
    Core Properties
    Core Methods
    Core Properties
    userID
    • @property (nonatomic, readonly) NSString *userID;

    • 一路 Track 所属用户的唯一标识

    trackID
    • @property (nonatomic, strong) NSString *trackID;

    • 一路 Track 在 Server 端的唯一标识

      发布成功时由 SDK 自动生成，订阅/Mute 等操作依据此 trackID 来确定相应的 Track

    kind
    • @property (nonatomic, readonly) QNTrackKind kind;

    • 标识该路 Track 是音频还是视频

    tag
    • @property (nonatomic, strong) NSString *tag;

    • Track 的 tag

    muted
    • @property (nonatomic, assign, readonly) BOOL muted;

    • 标识 Track 是否为 mute 状态

    delegate
    Core Methods
    updateMute
    • - (void)updateMute:(BOOL)mute;

    • 更新当前 Track 的 mute 值，静默后，SDK 将会发送静默帧数据

      当静默状态改变后，远端用户将会收到 QNRemoteAudioTrackDelegate.didMuteStateChanged 的回调

      Parameters
      • mute: BOOL

        是否静默 Track

    destroy
    • - (void)destroy;

    • 销毁本地音/视频 Track

      在不使用该 Track 之后，请务必调用此接口

    setVolume
    • - (void)setVolume:(double)volume;

    • 设置当前音频输入设备采集的音量大小

      音量值在 0.0 ~ 1.0 之间为软件缩小；1.0 为原始音量；大于 1.0 且小于 10.0 为软件放大

      在需要放大时，应从 1.x 开始设置，用最小的放大值来取得合适的播放效果，过大将会导致音频音调异常

      该设置可以用于适度对采集音量做放大或者缩小

      当麦克风输入音量增益调大之后，部分机型会出现噪音

      Parameters
      • volume: double

        音量值

    getVolumeLevel
    • - (float)getVolumeLevel;

    • 用户音量回调，volume 值在 [0, 1] 之间

      Returns float
    createAudioMusicMixer
    • - (QNAudioMusicMixer *)createAudioMusicMixer:(NSString *)musicPath musicMixerDelegate:(id<QNAudioMusicMixerDelegate>)musicMixerDelegate;

    • 创建背景音乐混音对象实例

      音频格式支持 aac、mp3、mp4、wav、m4r、caf、ogg、opus、m4a、flac

      1. 背景音乐混音仅支持同时混合一路背景音乐，若需要切换背景音乐，重新调用本接口创建 QNAudioMusicMixer 即可

      2. 建议使用本地文件进行混音，以避免网络环境差引起的混音异常

      3. 若您希望在混合背景音乐的同时添加音效，可参考音效混音相关接口 QNAudioEffectMixer

      Parameters
      Returns QNAudioMusicMixer
    destroyAudioMusicMixer
    • - (void)destroyAudioMusicMixer;

    • 销毁背景音乐混音类

    createAudioEffectMixer
    destroyAudioEffectMixer
    • - (void)destroyAudioEffectMixer;

    • 销毁多音效混音类

    createAudioSourceMixer
    destroyAudioSourceMixer
    • - (void)destroyAudioSourceMixer;

    • 销毁多音源混音类

    setEarMonitorEnabled
    • - (void)setEarMonitorEnabled:(BOOL)enabled;

    • 设置耳返开关，默认为 NO

      为达到最佳体验，建议佩戴耳机的场景下，使用该功能

      Parameters
      • enabled: BOOL

        开关

    getEarMonitorEnabled
    • - (BOOL)getEarMonitorEnabled;

    • 是否开启了耳返

      Returns BOOL
    setPlayingVolume
    • - (void)setPlayingVolume:(float)volume;

    • 设置混音、返听场景下，本地播放的音量大小，范围 0 ～ 1.0

      Parameters
      • volume: float

        播放音量

    getPlayingVolume
    • - (float)getPlayingVolume

    • 获取播放音量

      Returns float，范围 0 ～ 1.0
    以上内容是否对您有帮助？
    • Qvm free helper
    Close