抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JavaScript API
  • API 概览
  • 基础
  • 界面
  • 渲染
  • 数据缓存
  • 文件
  • 位置
  • 设备
  • 网络
  • 媒体
  • 图片
  • 音频
  • 录屏
  • 麦克风
  • 实时语音
  • 相机
  • 录音
  • RecorderManager
  • tt.getRecorderManager
  • tt.setInnerAudioOption
  • tt.getInnerAudioOption
  • tt.onAudioRouteChange
  • tt.offAudioRouteChange
  • 视频
  • AI
  • Worker
  • 数据分析
  • 支付
  • 广告
  • 开放能力
  • C# API
  • tt.setInnerAudioOption

    收藏
    我的收藏

    基础库 4.26.0 开始支持本方法,这是一个异步方法。

    用于在 RecorderManager 录音会话内设置小游戏音频播放路由优先从扬声器输出。

    前提条件无
    业务背景无
    使用限制

    当前不支持 Android。

    注意事项

    Android 当前不支持 setInnerAudioOption,调用会返回 999988 / The feature is not available in current operating system。

    在 RecorderManager 启动录音之后调用,可设置音频是否优先从扬声器输出;

    该能力不要与 RTC 路由能力混用;RTC 房间内如需切换扬声器/听筒,请使用 RtcRoomContext.setAudioPlaybackDevice。

    相关教程无

    语法

    tt.setInnerAudioOption(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    speakerOnboolean是

    true 设置扬声器播放;false 取消扬声器设置,让系统按当前模式和外设状态决定真实输出。

    4.26.0
    successfunction否
    接口调用成功的回调函数
    4.26.0
    failfunction否
    接口调用失败的回调函数
    4.26.0
    completefunction否
    接口调用结束的回调函数(调用成功、失败都会执行)
    4.26.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    routestring

    设置后的真实物理路由(speakerphone/earpiece/headset/bluetooth/unknown)

    4.26.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errNonumber

    错误码

    4.26.0
    errMsgstring

    错误信息

    4.26.0

    错误码

    errNoerrMsg说明最低支持版本
    21210setInnerAudioOption is not supported on current host version
    当前宿主版本不支持该能力,建议先 canIUse 探测
    4.26.0
    21211set audio route failed
    Recorder 未启动、外设占用或 iOS 系统设置失败
    4.26.0
    21214internal error
    4.26.0
    10302The feature is not available in current operating system
    Android 当前操作系统不支持 setInnerAudioOption
    4.26.0

    代码示例

    tt.setInnerAudioOption({ speakerOn: true, success(res) { console.log('setInnerAudioOption success', res); }, fail(err) { console.log('setInnerAudioOption fail', err); } });