Options
All
  • Public
  • Public/Protected
  • All
Menu

Hierarchy

Index

Methods

Abstract emit

  • emit(eventName: string, ...args: any[]): any
  • emit callback

    Parameters

    • eventName: string
    • Rest ...args: any[]

    Returns any

Abstract enableMicrophone

  • enableMicrophone(enable: boolean): void
  • 开启或关闭麦克风。

    支持版本:2.11.0 及以上。 详情描述:enable 为 "true" 时开启麦克风并推送音频流,为 "false" 时关闭麦克风并停止推送音频流。 业务场景:用户在房间内打开或关闭麦克风交流。 默认值:没有调用该函数时,默认关闭麦克风。 调用时机:在初始化范围语音 [createRangeAudio] 和 登录房间 [loginRoom] 之后。 注意事项:开启麦克风会自动使用主通道推音频流。 相关回调:通过回调 [onRangeAudioMicrophoneStateUpdate] 来获取麦克风开关状态变化。

    Parameters

    • enable: boolean

      是否开启麦克风。

    Returns void

Abstract enableSpatializer

  • enableSpatializer(enable: boolean): void
  • 开启或关闭 3D 音效。

    支持版本:2.11.0 及以上。 详情描述:开启3D音效后将根据发声者相当于听者的位置模拟实际空间中的声音效果,直观的感受就是音源远近和方位发生变化时声音大小和左右声音差也会发生变化。 业务场景:第一人称射击类游戏或社交场景游戏中听声辨位功能。 默认值:没有调用该函数时,默认关闭 3D 音效。 调用时机:在初始化范围语音 [createRangeAudio] 之后。 注意事项:该功能只对小队以外的人生效。 相关接口:开启 3D 音效后,可使用 [updateAudioSource] 或 [updateSelfPosition] 改变位置和朝向来体验 3D 效果。

    Parameters

    • enable: boolean

      是否开启 3D 音效。

    Returns void

Abstract enableSpeaker

  • enableSpeaker(enable: boolean): void
  • 开启或关闭扬声器。

    支持版本:2.11.0 及以上。 详情描述:enable 为 "true" 时开启扬声器并拉取音频流,为 "false" 时关闭扬声器并停止拉取音频流。 业务场景:用户在房间内打开或关闭扬声器收听。 默认值:没有调用该函数时,默认关闭扬声器。 调用时机:在初始化范围语音 [createRangeAudio] 和 登录房间 [loginRoom] 之后。 注意事项:开启扬声器会自动拉取房间内的音频流。

    Parameters

    • enable: boolean

      是否开启扬声器。

    Returns void

Abstract muteUser

  • muteUser(userID: string, mute: boolean): void
  • 是否可接收指定用户音频数据。

    支持版本:2.16.0 及以上。 详情描述:在实时音视频互动过程中,本地用户可根据需要,通过此函数控制是否接收指定远端用户的音频数据,当开发者不接收音频收据时,可降低硬件和网络的开销。 业务场景:当开发者需要快速关闭、恢复远端音频时,可调用此函数,提升互动体验。 默认值:默认为 “false”,即接收所有用户的音频数据。 调用时机:在初始化范围语音 [createRangeAudio] 之后。 注意事项:只有当 [muteAllPlayStreamAudio] 函数设置为 “false”时,此函数才有效。 相关接口:可调用 [muteAllPlayStreamAudio] 函数控制是否接收所有音频数据。1. 当调用 [muteAllPlayStreamAudio(true)] 函数时,全局生效,即本地用户会禁止接收所有远端用户的音频数据,此时无论在 [muteAllPlayStreamAudio] 之前还是之后调用 [muteUser] 函数都不生效。2. 当调用 [muteAllPlayStreamAudio(false)] 函数时,本地用户可以接收所有远端用户的音频数据,此时可再通过 [muteUser] 函数控制是否接收指定用户的音频数据。调用 [muteUser(userID, true)] 函数则本地用户可以接收该 “userID” 之外的其他音频数据;调用 [muteUser(userID, false)] 函数则本地用户可以接收 “userID” 的音频数据。

    Parameters

    • userID: string

      用户 ID。

    • mute: boolean

      是否可以接收指定远端用户的音频数据,“true” 表示禁止,“false” 表示接收,默认值为 “false”。

    Returns void

Abstract off

  • off<RangeAudioEventType>(event: RangeAudioEventType, callback: undefined | ZegoRangeAudioListener[RangeAudioEventType]): any
  • unregister callback

    Type parameters

    Parameters

    • event: RangeAudioEventType
    • callback: undefined | ZegoRangeAudioListener[RangeAudioEventType]

    Returns any

Abstract on

  • on<RangeAudioEventType>(event: RangeAudioEventType, callback: ZegoRangeAudioListener[RangeAudioEventType]): any
  • register callback

    Type parameters

    Parameters

    • event: RangeAudioEventType
    • callback: ZegoRangeAudioListener[RangeAudioEventType]

    Returns any

Abstract setAudioReceiveRange

  • 设置音频接收范围的配置。

    支持版本:3.7.0 及以上。 详情描述:设置音频接收范围,超过该范围的音源声音会听不见。 业务场景:“全世界” 模式下设置收听者的听觉范围。 默认值:没有调用该函数时,只能接收本小队内的成员声音,无法接收小队外的所有声音。 调用时机:在初始化范围语音 [createRangeAudio] 之后。 注意事项:该功能只对小队以外的人生效。

    Parameters

    Returns void

    错误码,详情请参考常用 错误码文档 https://doc-zh.zego.im/zh/4378.html

Abstract setPositionUpdateFrequency

  • setPositionUpdateFrequency(frequency: number): void
  • 设置SDK内部实时更新位置的频率

    支持版本:2.21.0 及以上。 详情描述:设置SDK内部实时更新位置的频率 最小15ms。 业务场景:对更新位置后,音频渐变灵敏度要求很高。 默认值: 默认100ms。 调用时机:在初始化范围语音 [createRangeAudio] 之后。

    Parameters

    • frequency: number

      更新频率,取值必须大于15ms。

    Returns void

Abstract setRangeAudioCustomMode

  • 设置范围语音的高阶自定义模式。

    支持版本:3.3.0 及以上。 详情描述:可以分别设置发声模式和收听模式,以控制在世界和小队中的发声和收听行为。 业务场景:用户可通过选择发声模式来决定谁能收听到他的声音,也可通过选择收听模式来决定收听谁的声音。 默认值:没有调用该接口时,默认使用 “发声到所有” 模式和 “收听所有” 模式,也就是 “全世界” 模式。 调用时机:在初始化范围语音 [createRangeAudio] 之后。 相关接口:当希望收听来自世界的声音时,需要设置声音接收范围 [setAudioReceiveRange]。当希望在小队中发声和收听时,需要设置 [setTeamID] 加入对应小队。 使用限制:1. 不能与 [setRangeAudioMode] 混用; 2. 与3.3.0之前的版本无法兼容。

    Parameters

    Returns void

Abstract setRangeAudioMode

  • 设置范围语音模式。

    支持版本:2.11.0 及以上。 详情描述:收听模式,可设置为 “全世界” 模式或 ”仅小队“ 模式。 业务场景:用户可选在 “全世界“ 模式下与所有人聊天(有距离限制),也可选择 ”仅小队“ 模式下团队内交流(无距离限制)。 默认值:没有调用该函数时,默认使用 “全世界” 模式。 调用时机:在初始化范围语音 [createRangeAudio] 之后。 相关接口:在 “全世界” 模式下可设置声音接收范围 [setAudioReceiveRange],在 “仅小队” 模式下需要设置 [setTeamID] 加入对应小队才能听到队伍内的声音。 使用限制:不能与 [setRangeAudioCustomMode] 混用。

    Parameters

    Returns void

Abstract setTeamID

  • setTeamID(teamID: string): void
  • 设置队伍 ID

    支持版本:2.11.0 及以上。 详情描述:设置队伍 ID 后,将能与同一队伍其他用户交流,且声音不会随距离方向产生变化;也可以通过设置空字符串来退出小队。 业务场景:用户加入小队交流或退出小队。 默认值:没有调用该函数时,默认不加入任何小队。 调用时机:在初始化范围语音 [createRangeAudio] 之后。 注意事项:小队内的声音不会有距离限制,也不会有 3D 音效。

    Parameters

    • teamID: string

      队伍 ID,为空退出小队,最大长度为 64 字节的字符串。支持数字,英文字符 和 '~', '!', '@', '#', '$', '', '^', '&', '*', '(', ')', '_', '+', '=', '-', ', ';', '’', ',', '.', '<', '>', '\'。

    Returns void

Abstract updateAudioSource

  • updateAudioSource(userID: string, position: number[]): void
  • 添加或更新音源位置信息。

    支持版本:2.11.0 及以上。 详情描述:设置 userID 对应的音源在房间内游戏地图位置,以便 SDK 计算听者与音源的距离和方位。 业务场景:更新发声用户在游戏地图坐标中的位置。 调用时机:调用 [loginRoom] 登录房间后调用,登出房间后会清空记录的音源信息。

    Parameters

    • userID: string

      发声者的 userID。

    • position: number[]

      发声者在世界坐标系中的坐标,参数是长度为 3 的 float 数组,三个值依次表示前、右、上的坐标值。

    Returns void

Abstract updateSelfPosition

  • updateSelfPosition(position: number[], axisForward: number[], axisRight: number[], axisUp: number[]): void
  • 更新自身的位置和朝向。

    支持版本:2.11.0 及以上。 详情描述:更新用户的位置和朝向,以便 SDK 计算出用户与音源距离以及左右耳立体声效果。 业务场景:当用户在游戏中操作的角色在世界地图中移动时,更新角色的位置信息以及头部朝向。 调用时机:在登录房间 [loginRoom] 后调用。 注意事项:在调用 [enableSpeaker] 打开扬声器之前如果没有调用该接口设置位置信息,则无法接收除小队以为其他人的声音。

    Parameters

    • position: number[]

      自身在世界坐标系中的坐标,参数是长度为 3 的 float 数组,三个值依次表示前、右、上的坐标值。

    • axisForward: number[]

      自身坐标系前轴的单位向量,参数是长度为 3 的 float 数组,三个值依次表示前、右、上的坐标值。

    • axisRight: number[]

      自身坐标系右轴的单位向量,参数是长度为 3 的 float 数组,三个值依次表示前、右、上的坐标值。

    • axisUp: number[]

      自身坐标系上轴的单位向量,参数是长度为 3 的 float 数组,三个值依次表示前、右、上的坐标值。

    Returns void

Generated using TypeDoc