更新记录

1.0.0(2020-08-10)

发布


平台兼容性

Android Android CPU类型 iOS
armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

请参考开源项目地址的开源协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问