harmony 鸿蒙Interface (AudioSpatializationManager)

  • 2025-06-12
  • 浏览 (6)

Interface (AudioSpatializationManager)

说明: 本模块首批接口从API version 18开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

空间音频管理。

在使用AudioSpatializationManager的接口之前,需先通过getSpatializationManager获取AudioSpatializationManager实例。

isSpatializationEnabledForCurrentDevice18+

isSpatializationEnabledForCurrentDevice(): boolean

获取当前设备空间音频渲染是否开启。同步返回结果。

系统能力: SystemCapability.Multimedia.Audio.Spatialization

返回值:

类型 说明
boolean 当前设备空间音频渲染是否开启。true表示开启,false表示未开启。

示例:

import { audio } from '@kit.AudioKit';

let isSpatializationEnabledForCurrentDevice: boolean = audioSpatializationManager.isSpatializationEnabledForCurrentDevice();
console.info(`AudioSpatializationManager isSpatializationEnabledForCurrentDevice: ${isSpatializationEnabledForCurrentDevice}`);

on(‘spatializationEnabledChangeForCurrentDevice’)18+

on(type: ‘spatializationEnabledChangeForCurrentDevice’, callback: Callback): void

监听当前设备空间音频渲染开关状态变化事件。使用callback异步回调。

系统能力: SystemCapability.Multimedia.Audio.Spatialization

参数:

参数名 类型 必填 说明
type string 事件回调类型,支持的事件为’spatializationEnabledChangeForCurrentDevice’,当空间音频渲染开关状态变化时,触发该事件。
callback Callback 回调函数。返回true表示打开空间音频渲染状态;返回false表示关闭空间音频渲染状态。

错误码:

以下错误码的详细介绍请参见Audio错误码

错误码ID 错误信息
6800101 Parameter verification failed.

示例:

import { audio } from '@kit.AudioKit';

audioSpatializationManager.on('spatializationEnabledChangeForCurrentDevice', (isSpatializationEnabledForCurrentDevice: boolean) => {
  console.info(`isSpatializationEnabledForCurrentDevice: ${isSpatializationEnabledForCurrentDevice}`);
});

off(‘spatializationEnabledChangeForCurrentDevice’)18+

off(type: ‘spatializationEnabledChangeForCurrentDevice’, callback?: Callback): void

取消监听当前设备空间音频渲染开关状态变化事件。使用callback异步回调。

系统能力: SystemCapability.Multimedia.Audio.Spatialization

参数:

参数名 类型 必填 说明
type string 事件回调类型,支持的事件为’spatializationEnabledChangeForCurrentDevice’,当取消订阅当前设备空间音频渲染开关状态变化事件时,触发该事件。
callback Callback 回调函数。返回true表示打开空间音频渲染状态;返回false表示关闭空间音频渲染状态。

错误码:

以下错误码的详细介绍请参见Audio错误码

错误码ID 错误信息
6800101 Parameter verification failed.

示例:

import { audio } from '@kit.AudioKit';
audioSpatializationManager.off('spatializationEnabledChangeForCurrentDevice');

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Audio Kit(音频服务)

harmony 鸿蒙Interface (AudioCapturer)

harmony 鸿蒙Interface (AudioManager)

harmony 鸿蒙Interface (AudioRenderer)

harmony 鸿蒙Interface (AudioRoutingManager)

harmony 鸿蒙Interface (AudioSessionManager)

harmony 鸿蒙Interface (AudioStreamManager)

harmony 鸿蒙Interface (AudioVolumeGroupManager)

harmony 鸿蒙Interface (AudioVolumeManager)

harmony 鸿蒙Constants

0  赞