开启耳返

说明

主播开启耳返后，可以在耳机里听到麦克风采集到的自己发出的声音，该特效适用于主播唱歌的应用场景中。
需要您注意的是，由于蓝牙耳机的硬件延迟非常高，所以在主播佩戴蓝牙耳机时无法开启此特效，请尽量在用户界面上提示主播佩戴有线耳机。
同时也需要注意，并非所有的手机开启此特效后都能达到优秀的耳返效果，我们已经对部分耳返效果不佳的手机屏蔽了该特效。目前 12.2 及其以上的版本针对硬件耳返的支持扩展到了荣耀、OPPO/一加、小米/红米等主流的机型。

方法名

enableVoiceEarMonitor

用法

• 用法如下：

uniapp

module.enableVoiceEarMonitor({
  params:{
  },
  //成功执行的函数
  success: (res) => {
    let data = res.data;
    console.log(data)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数，不管成功还是失败都会返回
  complete: (res) => {
    // console.log(res)
  }
})

uniappx

module.enableVoiceEarMonitor({
  params:{
  },
  //成功执行的函数
  success: (res) => {
    const data = res.data;
    console.log(data)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数，不管成功还是失败都会返回
  // complete: (res) => {
  //   console.log(res)
  // }
} as LevenOptions)

• 参数说明

  参数名	参数类型	是否必填	默认值	参数描述
  params	Object	是	无	参数配置
  params.enable	Boolean	是	无	true：开启；false：关闭
  success	Function	否	无	执行成功的函数
  fail	Function	否	无	执行失败的函数
  complete	Function	否	无	执行完成的函数，不管成功还是失败都会执行

  注意

  仅在主播佩戴耳机时才能开启此特效，同时请您提示主播佩戴有线耳机

OPPO配置

在 12.6 及其以上的版本，使用 OPPO 硬件耳返的客户需要在 OPPO 开放平台 中申请开通耳返的授权码，将自己应用的授权码配置到 AndroidManifest.xml 中。

<meta-data
    android:name="com.coloros.ocs.media.AUTH_CODE"
    android:value="请替换为自身授权码" />

配置完成后，此时打开耳返时会弹出悬浮球，关闭耳返后悬浮球消失，耳返的音量以及音效可以通过悬浮球来调节。
否则在打开耳返时会因为服务鉴权失败而自动切换为软件耳返。

荣耀配置

在 12.2 及其以上的版本，使用荣耀硬件耳返的客户需要在 AndroidManifest.xml 中配置如下字段。

<meta-data
    android:name="com.hihonor.hcs.client.appid"
    android:value="请替换为自身的 appid" />

否则在打开耳返的时候会偶现耳返无声现象，可能需要用户重新开关下硬件耳返才能正常听到耳返的声音。

回调

• 示例

{
"data": {},
"message": "",
"code": 0
}

• 回调说明：

  参数名	参数类型	参数描述
  message	String	消息提示
  data	Object	数据对象
  code	Integer	返回类型，0.成功，其他：失败