实时音视频

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

    QNMicrophoneAudioTrack

    最近更新时间: 2022-06-08 10:04:02

    本地音频麦克风 Track 类,可通过 QNRTC.createMicrophoneAudioTrack 方式创建该 Track 对象
    Hierarchy
    Index
    Core Methods
    Core Methods
    getTrackID
    • String getTrackID()
    • 获取 TrackID,仅当发布成功后,才可以获取到有效的 TrackID

      Returns String
    getUserID
    • String getUserID()
    • 获取 UserID

      Returns String
    getTag
    • String getTag()
    • 获取 Tag

      Returns String
    isAudio
    • boolean isAudio()
    • 是否为音频 Track

      Returns boolean
    isVideo
    • boolean isVideo()
    • 是否为视频 Track

      Returns boolean
    isMuted
    • boolean isMuted()
    • 该 Track 是否处于静默状态

      Returns boolean
    setMuted
    • void setMuted(boolean muted)
    • 设置是否静默该 track,静默后,SDK 将会发送静默帧数据

      当静默状态改变后,远端用户将会收到 QNTrackInfoChangedListener.onMuteStateChanged 的回调

      Parameters
      • muted: boolean

        是否静默

    destroy
    • void destroy()
    • 销毁本地创建的 Track

    setAudioFrameListener
    setMicrophoneEventListener
    setVolume
    • void setVolume(double volume)
    • 设置当前音频输入设备采集的音量大小

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

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

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

      Parameters
      • volume: double

        采集音量大小,[0.0 - 10.0],默认值为 1.0

    getVolumeLevel
    • float getVolumeLevel()
    • 获取当前音频输入设备采集的音量大小

      可通过定时调用该方法获取音量值的方式来判断当前用户是否在讲话

      在安静的环境下,获取到 0.0x 大小的数值为预期现象,您可根据您的需求自行决定判断的阈值

      Returns 采集音频音量大小
    createAudioMusicMixer
    • QNAudioMusicMixer createAudioMusicMixer(String musicPath, QNAudioMusicMixerListener listener)
    • 创建背景音乐混音控制器对象

      支持本地和在线文件,支持的文件格式为:aac、mp3、mp4、ogg、opus、wav、m4a、flac

      注意:

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

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

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

      Parameters
      • musicPath: String

        音频文件路径,支持本地文件和在线文件

      • 混音控制器监听接口

    createAudioEffectMixer
    setEarMonitorEnabled
    • void setEarMonitorEnabled(boolean enabled)
    • 开启、关闭返听

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

      Parameters
      • enabled: boolean

        是否开启返听

    isEarMonitorEnabled
    • boolean isEarMonitorEnabled()
    • 获取当前是否开启、关闭返听

      Returns 返听开启状态
    setPlayingVolume
    • void setPlayingVolume(float playingVolume)
    • 设置混音、返听场景下,本地播放的音量大小

      Parameters
      • playingVolume: float

        音量,[0.0f - 1.0f],默认值为 1.0f

    createAudioMixer
    • QNAudioMixer createAudioMixer(String musicPath, QNAudioMixerListener listener)
    • 创建混音控制器对象

      注意:

      1. 当前仅支持同一时间混一路音频,重复对不同的 QNAudioMixer 执行 start 操作,后面的会覆盖前面的,即以后执行 start 的音频混音控制器为准进行混音

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

      该接口已废弃

      最新接口实现,背景音乐混音可参考 QNAudioMusicMixer,音效混音可参考 QNAudioEffectMixer

      Parameters
      • musicPath: String

        音频文件路径,支持本地文件和在线文件

      • 混音器监听接口

      Returns QNAudioMixer
    以上内容是否对您有帮助?
  • Qvm free helper
    Close