Skip to content

设置 3D 音效中自身坐标及朝向信息

说明

更新自身在世界坐标系中的位置和朝向, SDK 会根据该方法参数计算自身和远端用户之间的相对位置,进而渲染出空间音效。

方法名

updateSelf3DSpatialPosition

用法

  • 用法如下:
js
module.updateSelf3DSpatialPosition({
  params:{
  },
  //成功执行的函数
  success: (res) => {
    let data = res.data;
    console.log(data)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数,不管成功还是失败都会返回
  complete: (res) => {
    // console.log(res)
  }
})
js
module.updateSelf3DSpatialPosition({
  params:{
  },
  //成功执行的函数
  success: (res) => {
    const data = res.data;
    console.log(data)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数,不管成功还是失败都会返回
  // complete: (res) => {
  //   console.log(res)
  // }
} as LevenOptions)
  • 参数说明

    参数名参数类型是否必填默认值参数描述
    paramsObject参数配置
    params.positionInteger[]自身在世界坐标系中的坐标,三个值依次表示前、右、上坐标值
    params.axisForwardFloat[]自身坐标系前轴在世界坐标系中的单位向量,三个值依次表示前、右、上坐标值
    params.axisRightFloat[]自身坐标系右轴在世界坐标系中的单位向量,三个值依次表示前、右、上坐标值
    params.axisUpFloat[]自身坐标系上轴在世界坐标系中的单位向量,三个值依次表示前、右、上坐标值
    successFunction执行成功的函数
    failFunction执行失败的函数
    completeFunction执行完成的函数,不管成功还是失败都会执行

    注意

    1. 各参数应分别传入长度为 3 的数组。
    2. 请适当限制调用频率,推荐两次坐标设置至少间隔 100ms

回调

  • 示例
json
{
"data": {},
"message": "",
"code": 0
}
  • 回调说明:
    参数名参数类型参数描述
    messageString消息提示
    dataObject数据对象
    codeInteger返回类型,0.成功,其他:失败