更新记录
1.0.0(2020-08-10) 下载此版本
发布
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
√ | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
插件介绍
安卓平台的音频管理
引用方式
const FvvAudioManager = uni.requireNativePlugin('Fvv-UniAudioManager')
API
//初始化,所有操作都需在初始化后执行
init()
//获取当前音量
getCurrentVolume(type)
//调整音量
adjustVolume(object)
//设置音量
setVolume(object)
//设置静音
setMute(object)
//获取当前音频模式
getMode()
//设置音频模式
setMode(type)
//获取当前铃声模式
getRingerMode()
//设置铃声模式
setRingerMode(type)
//打开扬声器
setSpeakerphoneOn(bool)
//设置麦克风静音
setMicrophoneMute(bool)
//获取麦克风是否静音
isMicrophoneMute()
//获取音乐活跃状态
isMusicActive()
//获取是否插入耳机
isWiredHeadsetOn()
//检查是否A2DP蓝牙耳机音频路由是打开或关闭
isBluetoothA2dpOn()
//检查是否sco蓝牙耳机音频路由是打开或关闭
isBluetoothScoOn()
//要求蓝牙进行通讯
setBluetoothScoOn(bool)
//启动蓝牙sco音频连接
startBluetoothSco()
//停止蓝牙sco音频连接
stopBluetoothSco()
初始化
init()
示例
FvvAudioManager.init();
获取当前音量
getCurrentVolume(type)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 音量类型不区分大小写:MUSIC媒体音量,ALARM闹钟音量,RING铃声音量,SYSTEM系统音量,CALL通话音量,NOTIFICATION通知音量,DTMF音调 |
返回值 int
参数 | 类型 | 说明 |
---|---|---|
int | int | 音量数值 0 - 100 |
示例
console.log(FvvAudioManager.getCurrentVolume("music"))
调整音量
adjustVolume(object)
object 参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 音量类型不区分大小写:MUSIC媒体音量,ALARM闹钟音量,RING铃声音量,SYSTEM系统音量,CALL通话音量,NOTIFICATION通知音量,DTMF音调 |
direction | string | 是 | 调整类型不区分大小写:SAME不变可用作显示当前音量,LOWER减小音量,RAISE增加音量 |
flag | int | 否 | 提示类型:0空,1音量进度条,4声音提示。 |
示例
FvvAudioManager.adjustVolume({
type:"music",
direction:"raise",
flag:1|4 //同时有进度条和声音提示
})
设置音量
setVolume(object)
object 参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 音量类型不区分大小写:MUSIC媒体音量,ALARM闹钟音量,RING铃声音量,SYSTEM系统音量,CALL通话音量,NOTIFICATION通知音量,DTMF音调 |
volume | int | 是 | 要调整的音量数值 0-100 |
flag | int | 否 | 提示类型:0空,1音量进度条,4声音提示。 |
示例
FvvAudioManager.setVolume({
type:"music",
volume:100,
flag:1|4 //同时有进度条和声音提示
})
设置静音
setMute(object)
object 参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 音量类型不区分大小写:MUSIC媒体音量,ALARM闹钟音量,RING铃声音量,SYSTEM系统音量,CALL通话音量,NOTIFICATION通知音量,DTMF音调 |
state | bool | 是 | 是否静音 |
示例
FvvAudioManager.setMute({
type:"music",
state:true,
})
获取当前音频模式
getMode()
返回值
参数 | 类型 | 说明 |
---|---|---|
mode | string | 音量模式:NORMAL正常,CALL打电话,COMMUNICATION通话,RINGTONE铃声 |
示例
console.log(FvvAudioManager.getMode())
设置音频模式
setMode(mode)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 音频模式不区分大小写:NORMAL正常,CALL打电话,COMMUNICATION通话,RINGTONE铃声 |
示例
FvvAudioManager.setMode("CALL")
获取当前铃声模式
getRingerMode()
返回值
参数 | 类型 | 说明 |
---|---|---|
mode | string | 铃声模式:NORMAL正常,SILENT静音,VIBRATE震动 |
示例
console.log(FvvAudioManager.getRingerMode())
设置铃声模式
setRingerMode(mode)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 铃声模式不区分大小写:NORMAL正常,SILENT静音,VIBRATE震动 |
示例
FvvAudioManager.setRingerMode("NORMAL")
打开扬声器
setSpeakerphoneOn(bool)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
bool | bool | 是 | 扬声器开关 |
示例
FvvAudioManager.setSpeakerphoneOn(true)
设置麦克风静音
setMicrophoneMute(bool)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
bool | bool | 是 | 麦克风是否静音 |
示例
FvvAudioManager.setMicrophoneMute(false)
获取麦克风是否静音
isMicrophoneMute()
返回值
参数 | 类型 | 说明 |
---|---|---|
bool | bool | 麦克风是否静音 |
示例
console.log(FvvAudioManager.isMicrophoneMute())
获取音乐活跃状态
isMusicActive()
返回值
参数 | 类型 | 说明 |
---|---|---|
bool | bool | 音乐活跃状态 |
示例
console.log(FvvAudioManager.isMusicActive())
获取是否插入耳机
isWiredHeadsetOn()
返回值
参数 | 类型 | 说明 |
---|---|---|
bool | bool | 是否插入耳机 |
示例
console.log(FvvAudioManager.isWiredHeadsetOn())
检查是否A2DP蓝牙耳机音频路由是打开或关闭
isBluetoothA2dpOn()
返回值
参数 | 类型 | 说明 |
---|---|---|
bool | bool | A2DP蓝牙耳机音频路由是打开或关闭 |
示例
console.log(FvvAudioManager.isBluetoothA2dpOn())
检查是否sco蓝牙耳机音频路由是打开或关闭
isBluetoothScoOn()
返回值
参数 | 类型 | 说明 |
---|---|---|
bool | bool | sco蓝牙耳机音频路由是打开或关闭 |
示例
console.log(FvvAudioManager.isBluetoothScoOn())
要求蓝牙进行通讯
setBluetoothScoOn(bool)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
bool | bool | 是 | 是否要求蓝牙进行通讯 |
示例
FvvAudioManager.setBluetoothScoOn(false)
启动蓝牙sco音频连接
startBluetoothSco()
示例
FvvAudioManager.startBluetoothSco(false)
停止蓝牙sco音频连接
stopBluetoothSco()
示例
FvvAudioManager.stopBluetoothSco(false)