1 Star 0 Fork 5.1K

youguilin / docs

forked from OpenHarmony / docs 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
音频管理.md 67.76 KB
一键复制 编辑 原始数据 按行查看 历史
NEEN 提交于 2021-06-02 22:39 . !333 update docs bugs

音频管理

说明: 由于权限问题,此部分功能在标准系统暂不可用,待更新。

导入模块

import audio from '@ohos.multimedia.audio';

权限

方法

getAudioManager()

获取音频管理器。

返回值:

类型

说明

AudioManager

音频管理类。

示例:

var audioManager = audio.getAudioManager();

枚举

AudioVolumeType

音频流类型。

名称

默认值

描述

MEDIA

1

表示媒体。

RINGTONE

2

表示铃声。

DeviceFlag

可获取的设备种类。

名称

默认值

描述

OUTPUT_DEVICES_FLAG

1

表示输出设备种类。

INPUT_DEVICES_FLAG

2

表示输入设备种类。

ALL_DEVICES_FLAG

3

表示所有设备种类。

DeviceRole

设备角色。

名称

默认值

描述

INPUT_DEVICE

1

输入设备角色。

OUTPUT_DEVICE

2

输出设备角色。

DeviceType

设备类型。

名称

默认值

描述

INVALID

0

无效设备。

SPEAKER

1

扬声器。

WIRED_HEADSET

2

有线耳机。

BLUETOOTH_SCO

3

SCO(Synchronous Connection Oriented Link)蓝牙设备。

BLUETOOTH_A2DP

4

A2DP(Advanced Audio Distribution Profile )蓝牙设备。

MIC

5

麦克风。

附录

AudioManager

音频管理器。

setVolume(AudioVolumeType, number, AsyncCallback<void>)

设置某个流的音量,使用callback方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

volume

number

音量。

callback

AsyncCallback<void>

回调表示成功还是失败。

示例:

audioManager.setVolume(audio.AudioVolumeType.MEDIA, 30, (err)=>{
   if (err) {
	   console.error(`failed to set volume ${err.message}`);
	   return;
   }
   console.log(`Media setVolume successful callback`);
})

setVolume(AudioVolumeType, number)

设置某个流的音量,使用promise方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

volume

number

音量。

返回值:

类型

说明

Promise<void>

Promise回调表示成功还是失败。

示例:

audioManager.setVolume(audio.AudioVolumeType.MEDIA, 30).then(()=>
    console.log(`Media setVolume successful callback`);
)

getVolume(AudioVolumeType, AsyncCallback<number>)

获取某个流的音量,使用callback方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

callback

AsyncCallback<number>

回调返回音量大小。

示例:

audioManager.getVolume(audio.AudioVolumeType.MEDIA, (err, value)=>{
   if (err) {
	   console.error(`failed to get volume ${err.message}`);
	   return;
   }
   console.log(`Media getVolume successful callback`);
})

getVolume(AudioVolumeType)

获取某个流的音量,使用promise方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

返回值:

类型

说明

Promise<number>

Promise回调返回音量大小。

示例:

audioManager.getVolume(audio.AudioVolumeType.MEDIA).then((data)=>
    console.log(`Media getVolume successful callback`);
)

getMinVolume(AudioVolumeType, AsyncCallback<number>)

获取某个流的最小音量,使用callback方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

callback

AsyncCallback<number>

回调返回最小音量。

示例:

audioManager.getMinVolume(audio.AudioVolumeType.MEDIA, (err, value)=>{
   if (err) {
	   console.error(`failed to get minvolume ${err.message}`);
	   return;
   }
   console.log(`Media getMinVolume successful callback`);
})

getMinVolume(AudioVolumeType)

获取某个流的最小音量,使用promise方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

返回值:

类型

说明

Promise<number>

Promise回调返回最小音量。

示例:

audioManager.getMinVolume(audio.AudioVolumeType.MEDIA).then((data)=>
    console.log(`Media getMinVolume successful callback`);
)

getMaxVolume(AudioVolumeType, AsyncCallback<number>)

获取某个流的最大音量,使用callback方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

callback

AsyncCallback<number>

回调返回最大音量大小。

示例:

audioManager.getMaxVolume(audio.AudioVolumeType.MEDIA, (err, value)=>{
   if (err) {
	   console.error(`failed to get maxvolume ${err.message}`);
	   return;
   }
   console.log(`Media getMaxVolume successful callback`);
})

getMaxVolume(AudioVolumeType)

获取某个流的最大音量,使用promise方式作为异步方法。

参数:

参数名

类型

必填

说明

audioType

AudioVolumeType

流类型。

返回值:

类型

说明

Promise<number>

Promise回调返回最大音量大小。

示例:

audioManager.getMaxVolume(audio.AudioVolumeType.MEDIA).then((data)=>
    console.log(`Media getMaxVolume successful callback`);
)

getDevices(DeviceFlag, AsyncCallback<AudioDeviceDescriptors>)

获取音频设备列表,使用callback方式作为异步方法。

参数:

参数名

类型

必填

说明

deviceFlag

DeviceFlag

设备类型的flag。

callback

AsyncCallback<AudioDeviceDescriptors>

回调,返回设备列表。

示例:

audioManager.getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG, (err, value)=>{
   if (err) {
	   console.error(`failed to get getdevices ${err.message}`);
	   return;
   }
   console.log(`Media getDevices successful callback`);
})

getDevices(DeviceFlag)

获取音频设备列表,使用promise方式作为异步方法。

参数:

参数名

类型

必填

说明

deviceFlag

DeviceFlag

设备类型的flag。

返回值:

类型

说明

Promise<AudioDeviceDescriptors>

Promise回调返回设备列表。

示例:

audioManager.getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG).then((data)=>
    console.log(`Media getDevices successful callback`);
)

AudioDeviceDescriptor

描述音频设备。

名称

类型

必填

描述

deviceRole

DeviceRole

设备角色。

deviceType

DeviceType

设备类型。

AudioDeviceDescriptors

名称

描述

设备属性队列

AudioDeviceDescriptor的队列,只读。

1
https://gitee.com/yougl/docs.git
git@gitee.com:yougl/docs.git
yougl
docs
docs
master

搜索帮助

53164aa7 5694891 3bd8fe86 5694891