Options
All
  • Public
  • Public/Protected
  • All
Menu

Class ZegoAudioEffectPlayer

Hierarchy

Index

Methods

Methods

Abstract getCurrentProgress

  • getCurrentProgress(audioEffectID: number): Promise<number>

  • 获取当前播放进度。

    支持版本：1.16.0 及以上。 详情描述：获取指定音效的当前播放进度。单位为毫秒。 调用时机：必须在加载资源完成后才能调用，否则返回值为 0。 使用限制：无。 相关接口：[start]，[loadResource]。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    Returns Promise<number>

Abstract getIndex

  • getIndex(): number

  • 获取音效播放器索引。

    支持版本：1.16.0 及以上。 详情描述：获取音效播放器索引。 调用时机：在 [createAudioEffectPlayer] 之后可调用。 使用限制：无。

    Returns number

    音效播放器索引。

Abstract getTotalDuration

  • getTotalDuration(audioEffectID: number): Promise<number>

  • 获取指定音效资源的总长度。

    支持版本：1.16.0 及以上。 详情描述：获取指定音效资源的总长度，单位为毫秒。 调用时机：必须在加载资源完成后才能调用，否则返回值为 0。 使用限制：在 [createAudioEffectPlayer] 之后可调用。 相关接口：[start]，[loadResource]。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    Returns Promise<number>

    单位为毫秒。

Abstract loadResource

  • 加载音效资源。

    支持版本：1.16.0 及以上。 详情描述：加载音效资源。 业务场景：在频繁播放相同音效场景中，SDK 为了优化重复读文件并解码的性能，提供了预加载音效文件到内存中的功能。 调用时机：在 [createAudioEffectPlayer] 之后可调用。 使用限制：预加载支持最多同时加载 15 个音效文件，并且音效文件时长不能超过 30s，否则加载会报错。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    • path: string

      音效资源路径，不能传入 null 或 ""。
      取值范围：目前仅支持播放本地文件，不支持 "assets://"、"ipod-library://" 和网络资源等。

    Returns Promise<ZegoAudioEffectPlayerLoadResourceResult>

    音效播放器加载资源完成的结果通知

Abstract off

  • off<AudioEffectPlayerEventType>(event: AudioEffectPlayerEventType, callback: undefined | ZegoAudioEffectPlayerListener[AudioEffectPlayerEventType]): void

  • 注销监听媒体播放器事件回调

    Type parameters

    Parameters

    • event: AudioEffectPlayerEventType

      事件类型。

    • callback: undefined | ZegoAudioEffectPlayerListener[AudioEffectPlayerEventType]

      事件回调。

    Returns void

Abstract on

  • on<AudioEffectPlayerEventType>(event: AudioEffectPlayerEventType, callback: ZegoAudioEffectPlayerListener[AudioEffectPlayerEventType]): void

  • 注册监听媒体播放器事件回调

    Type parameters

    Parameters

    • event: AudioEffectPlayerEventType

      事件类型。

    • callback: ZegoAudioEffectPlayerListener[AudioEffectPlayerEventType]

      事件回调。

    Returns void

Abstract pause

  • pause(audioEffectID: number): Promise<void>

  • 暂停播放音效。

    支持版本：1.16.0 及以上。 详情描述：暂停播放指定的音效 [audioEffectID]。 调用时机：指定的 [audioEffectID] 已经 [start]。 使用限制：无。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    Returns Promise<void>

Abstract pauseAll

  • pauseAll(): Promise<void>

  • 暂停播放所有音效。

    支持版本：1.16.0 及以上。 详情描述：暂停播放所有音效。 调用时机：在 [createAudioEffectPlayer] 之后可调用。 使用限制：无。

    Returns Promise<void>

Abstract resume

  • resume(audioEffectID: number): Promise<void>

  • 恢复播放音效。

    支持版本：1.16.0 及以上。 详情描述：恢复播放指定的音效 [audioEffectID]。 调用时机：指定的 [audioEffectID] 处于 [pause] 状态。 使用限制：无。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    Returns Promise<void>

Abstract resumeAll

  • resumeAll(): Promise<void>

  • 恢复播放所有音效。

    支持版本：1.16.0 及以上。 详情描述：恢复播放所有音效。 调用时机：在 [pauseAll] 之后可调用。 使用限制：无。

    Returns Promise<void>

Abstract seekTo

  • 设置播放进度。

    支持版本：1.16.0 及以上。 详情描述：设置指定音效的播放进度，单位为毫秒。 调用时机：指定的 [audioEffectID] 已经 [start]，且还没有播完。 使用限制：无。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    • millisecond: number

      指定的播放进度的时间点。

    Returns Promise<ZegoAudioEffectPlayerSeekToResult>

    音效播放器设置指定播放进度的结果通知

Abstract setVolume

  • setVolume(audioEffectID: number, volume: number): Promise<void>

  • 设置单个音效的播放音量，会同时设置本地播放音量和推流音量。

    支持版本：1.16.0 及以上。 详情描述：设置指定音效的播放音量，会同时设置本地播放音量和推流音量。 调用时机：指定的 [audioEffectID] 已经 [start]。 使用限制：无。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    • volume: number

      音量值。
      取值范围：范围为 0 ~ 200。
      默认值：默认为 100。

    Returns Promise<void>

Abstract setVolumeAll

  • setVolumeAll(volume: number): Promise<void>

  • 设置所有音效的播放音量，会同时设置本地播放音量和推流音量。

    支持版本：1.16.0 及以上。 详情描述：设置所有音效的播放音量，会同时设置本地播放音量和推流音量。 调用时机：在 [createAudioEffectPlayer] 之后可调用。 使用限制：无。

    Parameters

    • volume: number

      音量值。
      取值范围：范围为 0 ~ 200。
      默认值：默认为 100。

    Returns Promise<void>

Abstract start

  • 开始播放音效。

    支持版本：1.16.0 及以上。 详情描述：开始播放音效，默认仅播放一次，且不会将音效混入推流中，如需修改请配置 [config] 参数。 业务场景：当需要播放简短的声音效果，比如鼓掌，欢呼声等时，可以使用该接口实现，进一步通过 [config] 参数配置播放次数，将音效混入推流中。 调用时机：在 [createAudioEffectPlayer] 之后可调用。 使用限制：无。

    Parameters

    • audioEffectID: number

      音效资源的 ID。SDK 内部使用 audioEffectID 进行音效的播放控制，SDK 不强制用户以固定形式的值传入该参数，最好保证每个音效可以有唯一的 ID，推荐的方式有静态自增 ID 和传入音效文件路径的 hash 两种方式。

    • path: undefined | string

      音效资源的路径。
      取值范围：目前仅支持播放本地文件，不支持 "assets://"、"ipod-library://" 和网络资源等。如果之前使用 [loadResource] 预先加载了音效，可传入 null 或 ""。

    • config: undefined | ZegoAudioEffectPlayConfig

      音效播放配置。
      默认值：传空则仅播放一次，且不会混音入推流中。

    Returns Promise<void>

Abstract stop

  • stop(audioEffectID: number): Promise<void>

  • 停止播放音效。

    支持版本：1.16.0 及以上。 详情描述：停止播放指定的音效 [audioEffectID]。 调用时机：指定的 [audioEffectID] 已经 [start] 。 使用限制：无。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    Returns Promise<void>

Abstract stopAll

  • stopAll(): Promise<void>

  • 停止播放所有音效。

    支持版本：1.16.0 及以上。 详情描述：停止播放所有音效。 调用时机：正在播放音效。 使用限制：无。

    Returns Promise<void>

Abstract unloadResource

  • unloadResource(audioEffectID: number): Promise<void>

  • 卸载音效资源。

    支持版本：1.16.0 及以上。 详情描述：卸载指定音效的音效资源。 调用时机：在音效使用完毕之后，可以通过此函数释放相关资源；否则 SDK 将在 AudioEffectPlayer 实例销毁时释放加载的资源。 使用限制：无。 相关接口：[loadResource]。

    Parameters

    • audioEffectID: number

      音效资源的 ID。

    Returns Promise<void>

Generated using TypeDoc