更新记录

2.0.0（2023-03-13）

1. 新增内测接口认证功能;

1.1.0（2022-05-25）

1. 修复init函数参数名称错误bug;
2. 修复加载监听返回的事件名错误bug;

1.0.0（2022-04-25）

1. 发布正版曲库基础功能；

平台兼容性

原生插件通用使用流程：

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

腾讯云正版曲库

聚合 TME 等多家版权方优质曲目资源，结合腾讯云存储、编解码、内容分发、边缘计算等能力，有效解决多场景音乐素材应用版权问题。支持视频直播、语音电台、语聊房、线上KTV、直播电商等场景，便捷应用，高效完成版权音乐在多端的播放和使用。

技术支持

建议扫码添加我们技术支持，协助接入和开发。

联系我们	微信号	更多功能
	ruanyunkeji006	搜索 KTV 曲库 查询曲库歌曲详情

快速开始

步骤1: 集成插件

• 加载插件

加载uniapp平台的原生插件，需要自定义基座后才能使用，您可以按照自定义基座文档进行。

插件名称: RY-TencentCopyrightedMedia

在使用前，需要先加载插件。

var copyrightedMedia = uni.requireNativePlugin("RY-TencentCopyrightedMedia");

• 腾讯云配置

注册或登录腾讯云账号，并进行实名认证。

1. 正版曲库直通车 AME 服务开通：登录 正版曲库直通车 AME 控制台 后，您可在勾选同意 腾讯云服务协议 以及 正版曲库直通车服务协议 后单击立即开通，即可开通服务。
2. 实时音视频 TRTC 服务开通：登录 实时音视频 TRTC 控制台 开通并使用产品。
3. 您可在左导航栏进入正版曲库直通车控制台 > 应用管理 页面，单击创建应用，根据弹窗填空提示，填写相应的信息；

步骤2: 开始使用插件

需要先调用 [init]() 初始化插件，才可以调用其他的接口功能。

copyrightedMedia.init({}, ret => {
    console.log(ret);
});

步骤3: 设置预加载监听

调用 [setPreloadMusicListener]() 可以设置预加载监听器，监听器会返回相关的回调事件。

copyrightedMedia.setPreloadMusicListener({}, ret => {
    console.log(ret);
});

步骤4: 预加载 Music 数据

每次播放/重播前都需要调用该接口 [preloadMusic]() 。

copyrightedMedia.preloadMusic({
    musicId: 'musicIdxxx',
    bitrateDefinition: 'audio/mi：64',
    playToken: 'woixqwixxxoieqywmx'
}, ret => { 
    console.log(ret);
});

步骤5: 生成URI

客户端在 preloadMusic 成功之后调用 [genMusicUri]()，原唱&伴奏传给 TRTC 进行播放。

copyrightedMedia.genMusicUri({
    musicId: 'musicIdxxx',
    musicType: 1,
    bitrateDefinition: 'audio/mi：64'
}, ret => {
    console.log(ret);
});

更多功能

• 搜索KTV曲库
• 查询曲库歌曲详情

扫码添加, 获取技术支持:

微信号: ruanyunkeji006