更新记录

0.0.1（2019-08-15）

自定义iOS推送铃声

平台兼容性

原生插件通用使用流程：

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

此插件已转移到 自定义推送铃声（Android、iOS），同时支持Android、iOS平台，请大家使用新的插件；

插件说明

自定义 iOS 端推送提示音

注：使用该插件前提，请确保您的项目已经集成推送并可以正常收到推送消息。

插件使用说明

1.绑定插件使用的项目

• 在插件页面选择（购买 for 云打包），并勾选使用插件的项目；

2.在 HBuilderX 中配置项目

• 选择 manifest -> App原生插件配置 -> 云端插件 -> 选择云端插件 -> 勾选此插件
  

  

• 在项目根目录中的 nativeplugins目录中新建DC-PushSound目录，在DC-PushSound目录中新建ios目录，然后在ios目录中放入铃声文件 pushsound.caf 注意，文件必须命名为pushsound.caf

  说明
  

  • nativeplugins 目录为原生插件目录，如果没有的话请自行创建此目录
    
  • DC-PushSound 目录为该插件目录，DC-PushSound为该插件的ID，必须拼写正确
    
  • pushsound.caf为插件配置的铃声名称，必须是 caf 音频文件并且必须命名为pushsound.caf，下面有将其他类型音频文件转成caf文件的方法

  

• 音频文件转换 caf 文件方法（仅 mac 系统，windows系统可以通过pp助手转换音频，或者自行搜索一下音频转换工具）

  时长要求 30 秒以内

  打开终端cd到音频文件所在目录，运行命令：（注：将 提示音.m4r 改成你自己的铃声，支持 mp3 或其他格式的音频转换）

  afconvert 提示音.m4r pushsound.caf -d ima4 -f caff -v

3.打自定义基座测试

• 重新打自定义基座，运行到测试机

• 后端推送测试时请将 iOS 的 apns 配置信息中的 sound 字段值改为 pushsound.caf

  php 示例

  $payload = '{"title":"测试标题","content":"测试内容","sound":"pushsound.caf","payload":"test"}';  
  $intent = 'intent:#Intent;action=android.intent.action.oppopush;launchFlags=0x14000000;component=io.dcloud.HBuilder/io.dcloud.PandoraEntry;S.UP-OL-SU=true;S.title=测试标题;S.content=测试内容;S.payload=test;end';  
  
  $template =  new IGtTransmissionTemplate();//使用透传消息模板  
  $template->set_appId(APPID);//应用appid  
  $template->set_appkey(APPKEY);//应用appkey  
  $template->set_transmissionType(2);//透传消息类型  
  $template->set_transmissionContent($payload);//消息内容  
  
  $notify = new IGtNotify();  
  $notify->set_title('测试标题');  
  $notify->set_content('测试内容');  
  $notify->set_intent($intent);  
  $notify->set_type(NotifyInfo_type::_intent);  
  
  $template->set3rdNotifyInfo($notify);  

添加多个音频文件

如需支持多个音频文件按下面的步骤操作

1.在插件页面选择（下载 for 离线打包），将下载的插件包解压；

2.将 DC-PushSound 文件夹拷贝到 uni工程 nativeplugins 路径下；

3.将多个音频文档放到插件目录中 ios 路径下；

4.编辑插件目录中的 package.json，在 resource 节点中填写音频文件名称；

5.选择 manifest -> App原生插件配置 -> 本地插件 -> 选择本地插件 -> 勾选此插件

6.然后就可以制作自定义基座进行测试；