更新记录

1.0.0(2022-07-08)

新版首发


平台兼容性

Android iOS
× 适用版本区间:9 - 16

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


KJ-MediaPicker

媒体资源库、音频资料库、ipod音频、查询所有歌曲、歌曲转存(ios)

使用

<template>
    <view class="content">
        <button type="primary" @click="openVC">打开资料库选择音频</button>
        <button type="primary" @click="getMediaItems">查询所有歌曲</button>
        <button type="primary" @click="assetURLSaveToDocPath">根据歌曲的assetURL保存到doc路径</button>
        <view>{{json}}</view>
    </view>
</template>

<script>
    const KJMediaPicker = uni.requireNativePlugin('KJ-MediaPicker');
    export default {
        data() {
            return {
                json: null,
                mediaItems: null
            }
        },
        onLoad() {

        },
        methods: {
            openVC() {
                /**
                 * mediaType:媒体类型,1 << 0(音乐)1 << 2(播客) 1 << 3(有声书) 1 << 4(iTunesU音频课程) 0x00ff(所有音频)
                 * allowsPickingMultipleItems:是否允许选择多个项目
                 * showsCloudItems:是否显示Cloud项目
                 * showsItemsWithProtectedAssets:是否显示具有受保护资产的项目,ios9.2及以上支持
                 * prompt:导航栏标题
                 * */
                var dic = {
                    "mediaType": 0x00ff | 1 << 0,
                    "allowsPickingMultipleItems": true,
                    "showsCloudItems": true,
                    "showsItemsWithProtectedAssets": true,
                    "prompt": "请选择",
                }
                KJMediaPicker.openVC(dic, (res) => {
                    /**
                     * 返回字段说明:{"result":true,"error":null,"values":[{"assetURL":"ipod-library://item/item.mp3?id=4396965973439318525",
                     * "title":"voiceAtShop","savePath":"绝对路径/voiceAtShop.mp3","pathExtension":"mp3"}]}
                     * title:音频名字
                     * savePath:音频保存到_doc目录的路径
                     * pathExtension:音频扩展名
                     * 。。。更多字段意思,参考:https://developer.apple.com/documentation/mediaplayer/mpmediaitem
                     * */
                    this.json = JSON.stringify(res);
                    console.log("点击完成按钮回调:" + JSON.stringify(res))
                }, (res) => {
                    console.log("点击取消按钮回调:" + JSON.stringify(res))
                });
            },
            getMediaItems() {
                KJMediaPicker.getMediaItems({}, (res) => {
                    this.json = JSON.stringify(res);
                    console.log("getMediaItems:" + JSON.stringify(res))
                    this.mediaItems = res.values;
                });
            },
            assetURLSaveToDocPath() {
                KJMediaPicker.assetURLSaveToDocPath(this.mediaItems, (res) => {
                    this.json = JSON.stringify(res);
                    console.log("assetURLSaveToDocPath:" + JSON.stringify(res))
                });
            }
        }
    }
</script>

隐私、权限声明

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

媒体资料库权限(NSAppleMusicUsageDescription)

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

插件不采集任何数据

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

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