Interfaces (其他)

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

AudioStreamInfo⁸⁺

音频流信息。

系统能力： SystemCapability.Multimedia.Audio.Core

AudioRendererInfo⁸⁺

音频渲染器信息。

AudioRendererOptions⁸⁺

音频渲染器选项信息。

InterruptEvent⁹⁺

音频中断时，应用接收的中断事件。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Multimedia.Audio.Renderer

DeviceBlockStatusInfo¹³⁺

描述音频设备被堵塞状态和设备信息。

系统能力： SystemCapability.Multimedia.Audio.Device

AudioSessionStrategy¹²⁺

音频会话策略。

系统能力： SystemCapability.Multimedia.Audio.Core

AudioSessionDeactivatedEvent¹²⁺

音频会话停用事件。

系统能力： SystemCapability.Multimedia.Audio.Core

AudioRendererChangeInfo⁹⁺

描述音频渲染器更改信息。

系统能力： SystemCapability.Multimedia.Audio.Renderer

示例：

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

const audioManager = audio.getAudioManager();
let audioStreamManager = audioManager.getStreamManager();

audioStreamManager.on('audioRendererChange',  (AudioRendererChangeInfoArray) => {
  for (let i = 0; i < AudioRendererChangeInfoArray.length; i++) {
    console.info(`## RendererChange on is called for ${i} ##`);
    console.info(`StreamId for ${i} is: ${AudioRendererChangeInfoArray[i].streamId}`);
    console.info(`Content for ${i} is: ${AudioRendererChangeInfoArray[i].rendererInfo.content}`);
    console.info(`Stream for ${i} is: ${AudioRendererChangeInfoArray[i].rendererInfo.usage}`);
    console.info(`Flag ${i} is: ${AudioRendererChangeInfoArray[i].rendererInfo.rendererFlags}`);
    let devDescriptor = AudioRendererChangeInfoArray[i].deviceDescriptors;
    for (let j = 0; j < AudioRendererChangeInfoArray[i].deviceDescriptors.length; j++) {
      console.info(`Id: ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].id}`);
      console.info(`Type: ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].deviceType}`);
      console.info(`Role: ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].deviceRole}`);
      console.info(`Name: ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].name}`);
      console.info(`Addr: ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].address}`);
      console.info(`SR: ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].sampleRates[0]}`);
      console.info(`C ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].channelCounts[0]}`);
      console.info(`CM: ${i} : ${AudioRendererChangeInfoArray[i].deviceDescriptors[j].channelMasks[0]}`);
    }
  }
});

AudioCapturerChangeInfo⁹⁺

描述音频采集器更改信息。

系统能力： SystemCapability.Multimedia.Audio.Capturer

示例：

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

const audioManager = audio.getAudioManager();
let audioStreamManager = audioManager.getStreamManager();

audioStreamManager.on('audioCapturerChange', (AudioCapturerChangeInfoArray) =>  {
  for (let i = 0; i < AudioCapturerChangeInfoArray.length; i++) {
    console.info(`## CapChange on is called for element ${i} ##`);
    console.info(`StrId for  ${i} is: ${AudioCapturerChangeInfoArray[i].streamId}`);
    console.info(`Src for ${i} is: ${AudioCapturerChangeInfoArray[i].capturerInfo.source}`);
    console.info(`Flag ${i} is: ${AudioCapturerChangeInfoArray[i].capturerInfo.capturerFlags}`);
    let devDescriptor = AudioCapturerChangeInfoArray[i].deviceDescriptors;
    for (let j = 0; j < AudioCapturerChangeInfoArray[i].deviceDescriptors.length; j++) {
      console.info(`Id: ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].id}`);
      console.info(`Type: ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].deviceType}`);
      console.info(`Role: ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].deviceRole}`);
      console.info(`Name: ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].name}`);
      console.info(`Addr: ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].address}`);
      console.info(`SR: ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].sampleRates[0]}`);
      console.info(`C ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].channelCounts[0]}`);
      console.info(`CM ${i} : ${AudioCapturerChangeInfoArray[i].deviceDescriptors[j].channelMasks[0]}`);
    }
  }
});

AudioDeviceDescriptor

描述音频设备。

示例：

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

function displayDeviceProp(value: audio.AudioDeviceDescriptor) {
  deviceRoleValue = value.deviceRole;
  deviceTypeValue = value.deviceType;
}

let deviceRoleValue: audio.DeviceRole|undefined = undefined;
let deviceTypeValue: audio.DeviceType|undefined = undefined;
audio.getAudioManager().getRoutingManager().getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG).then((value: audio.AudioDeviceDescriptors) => {
  console.info('AudioFrameworkTest: Promise: getDevices OUTPUT_DEVICES_FLAG');
  value.forEach(displayDeviceProp);
  if (deviceTypeValue != undefined && deviceRoleValue != undefined){
    console.info('AudioFrameworkTest: Promise: getDevices : OUTPUT_DEVICES_FLAG :  PASS');
  } else {
    console.error('AudioFrameworkTest: Promise: getDevices : OUTPUT_DEVICES_FLAG :  FAIL');
  }
});

VolumeEvent⁹⁺

音量改变时，应用接收到的事件。

系统能力： SystemCapability.Multimedia.Audio.Volume

MicStateChangeEvent⁹⁺

麦克风状态变化时，应用接收到的事件。

系统能力： SystemCapability.Multimedia.Audio.Device

DeviceChangeAction

描述设备连接状态变化和设备信息。

系统能力： SystemCapability.Multimedia.Audio.Device

AudioStreamDeviceChangeInfo¹¹⁺

流设备变更时，应用接收到的事件。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Multimedia.Audio.Device

AudioTimestampInfo¹⁹⁺

音频流时间戳和当前数据帧位置信息。

系统能力： SystemCapability.Multimedia.Audio.Core

AudioCapturerInfo⁸⁺

描述音频采集器信息。

系统能力： SystemCapability.Multimedia.Audio.Core

AudioCapturerOptions⁸⁺

音频采集器选项信息。

AudioInterrupt^(deprecated)

音频监听事件传入的参数。

说明：

从API version 7开始支持，从API version 9开始废弃，无替代接口。

系统能力： SystemCapability.Multimedia.Audio.Renderer

CaptureFilterOptions^(deprecated)

待录制的播放音频流的筛选信息。

说明： 从API version 10开始支持，从API version 12开始废弃，建议使用录屏接口AVScreenCapture替代。

系统能力： SystemCapability.Multimedia.Audio.PlaybackCapture

AudioPlaybackCaptureConfig^(deprecated)

音频内录的配置信息。

说明： 从API version 10开始支持，从API version 12开始废弃，建议使用录屏接口AVScreenCapture替代。

系统能力： SystemCapability.Multimedia.Audio.PlaybackCapture

InterruptAction^(deprecated)

音频打断/获取焦点事件的回调方法。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用InterruptEvent替代。

系统能力： SystemCapability.Multimedia.Audio.Renderer

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Audio Kit（音频服务）

harmony 鸿蒙Interface (AudioCapturer)

harmony 鸿蒙Interface (AudioManager)

harmony 鸿蒙Interface (AudioRenderer)

harmony 鸿蒙Interface (AudioRoutingManager)

harmony 鸿蒙Interface (AudioSessionManager)

harmony 鸿蒙Interface (AudioSpatializationManager)

harmony 鸿蒙Interface (AudioStreamManager)

harmony 鸿蒙Interface (AudioVolumeGroupManager)

harmony 鸿蒙Interface (AudioVolumeManager)