更新记录
1.0.1(2022-10-21)
1.初版
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:6.0 - 12.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 | 适用版本区间:9 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
BenBen-AudioPlayer使用说明
1、打开播放器
方法名:openTheAudioPlayer
传入参数:list(json字符串)
返回参数:code、data、msg (报错会返回错误信息)
代码示例
const audioPlayerModule = uni.requireNativePlugin("BenBen-AudioPlayer")
const modal = uni.requireNativePlugin('modal');
export default {
onLoad() {
plus.globalEvent.addEventListener('TestEvent', function(e) {
modal.toast({
message: "TestEvent收到:" + e.msg,
duration: 1.5
});
});
},
methods: {
openTheAudioPlayer() {
// 打开播放器
audioPlayerModule.openTheAudioPlayer({
'list': '[{"id":31,"user_id":512,"title":"花火","image":"http:\/\/leyin.njzb.vip\/uploads\/images\/21\/b7162cc8c5f2f672f79eb79330609b.jpg","source":"http:\/\/leyinyu.oss-cn-shanghai.aliyuncs.com\/uploads\/images\/20221015\/f3edcf2f5a651eb2485bd9ca1fa12e4a.mp3","is_delete":0,"create_time":1666084581},{"id":26,"user_id":512,"title":"以学愈愚语音","image":"http:\/\/leyin.njzb.vip\/uploads\/images\/b3\/27b0ede30df691749d29f9797e0229.jpeg","source":"http:\/\/leyinyu.oss-cn-shanghai.aliyuncs.com\/uploads\/images\/20221011\/2eef8b934d8a15d1e8c1d4114be0e3f9.mp3","is_delete":0,"create_time":1665565478},{"id":21,"user_id":512,"title":"儿歌多多","image":"http:\/\/leyin.njzb.vip\/uploads\/images\/6a\/31b25d05db1d4983d3605aac20074e.jpg","source":"http:\/\/leyinyu.oss-cn-shanghai.aliyuncs.com\/uploads\/images\/20221007\/d6e020197c0471fe70d3955b97927e2e.mp3","is_delete":0,"create_time":1665541027}]'
},
(ret) => {
modal.toast({
message: ret,
duration: 1.5
});
})
}
}
}
iOS 云打包后台权限配置教程
iOS App 在使用一些功能时需要申请后台权限,比如后台音频播放、后台定位等,在提交云打包时,需要在 manifest.json 的 "app-plus" -> "distribute" -> "ios" -> "UIBackgroundModes"
节点添加对应权限的 描述key 即可;
注意:后台权限用不到千万不要填写,以免审核被拒
{
"app-plus" : {
/* 应用发布信息 */
"distribute" : {
/* ios打包配置 */
"ios" : {
"UIBackgroundModes" : [ "audio"] // 数组,支持多个
},
...
}
}
}