更新记录
1.0.0(2023-07-03)
首次提交
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 10.0 | 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原生插件配置”->”云端插件“列表中删除该插件重新选择
音频播放
1、插件说明
此插件适用于 MediaPlayer 音频播放 支持定制、如有需要请联系我 wx:petalmailo。
2、代码示例
<template>
<view class="hd-container">
<form-item title="音频地址" :value="audioUrl" clear />
<view class="hd-btn" @click="init">开始【网络地址】</view>
<view class="hd-btn" @click="playAudio">播放</view>
<view class="hd-btn" @click="pauseAudio">暂停</view>
<view class="hd-btn" @click="fastForward(10)">快进10秒</view>
<view class="hd-btn" @click="rewind(15)">后退15秒</view>
<view class="hd-btn" v-if="audioData.currentTime && !audioData.finish">当前播放位置: {{audioData.currentTime}}</view>
<view class="hd-btn" v-if="audioData.duration && !audioData.finish">总的播放时长: {{audioData.duration}}</view>
</view>
</template>
<script>
let audioPlugin
// #ifdef APP-PLUS
audioPlugin = uni.requireNativePlugin('plugin-AudioModule');
// #endif
export default {
data() {
return {
mp3Url: "/static/mhwt.mp3",
audioData: {
finish: false
},
audioUrl: `http://hz1112256.oss-cn-hangzhou.aliyuncs.com/user_audio/mp3/2023-06-26/168776802133486.mp3`
};
},
onLoad() {
// #ifdef APP-PLUS
audioPlugin.audioCallback(res => { // 全局返回监听
console.log(`audioCallback`, JSON.stringify(res));
if (res && res.type == 'currentTime') { // 当前播放位置
this.audioData.currentTime = res.data
}
if (res && res.type == 'duration') { // 音频总时长
this.audioData.duration = res.data
}
if (res && res.type == 'finish') { //播放结束
uni.showToast({
title: '音频播放结束',
duration: 1500
});
this.audioData.finish = true
}
if (res && res.type == 'error') { //播放异常
this.audioData.finish = true
}
this.$forceUpdate()
})
// #endif
},
methods: {
init() {
plus.android.requestPermissions(['android.permission.RECORD_AUDIO'], (e) => {
this.audioData.finish = false
this.audioData.currentTime = ''
this.audioData.duration = ''
/* 将本地文件系统的绝对路径转换 */
const filePath = plus.io.convertLocalFileSystemURL(this.mp3Url)
audioPlugin.audioUrl(filePath);//资源准备好了就开始播放
}, function(e) {
console.log('Request Permissions error:' + JSON.stringify(e));
});
},
/* 播放 */
playAudio() {
audioPlugin.playAudio()
this.audioData.finish = false
},
/* 暂停 */
pauseAudio() {
audioPlugin.pauseAudio()
},
/* // 快进快退(跳转到指定的时间) */
fastForward(num) {
audioPlugin.fastForward(num)
},
/* // 快进快退(跳转到指定的时间) */
rewind(num) {
audioPlugin.rewind(num)
}
}
};
</script>