这里会显示出您选择的修订版和当前版本之间的差别。
razor:plugins:getui [2015/03/18 19:01] cobub 创建 |
razor:plugins:getui [2017/07/14 11:18] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== 个推 – Android推送服务 ====== | ||
- | |||
- | 个推插件 是Cobub Razor官方基于个推开发的一款推送插件。 | ||
- | 它集成了个推的推送功能与Cobub Razor提供的Tag功能,更加方便,快捷,精准的进行推送。 | ||
- | 个推开放平台帮助企业的应用通过低成本互联网通道进行消息推送,提供完善、高效、稳定的服务体系解决了互联网云端到手机端的消息互通问题。 | ||
- | |||
- | ===== 集成步骤: ===== | ||
- | |||
- | |||
- | 在集成个推插件之前,确保数据库个推相关表的建立,可以到这里下载相关的sql文件,导入到你的数据库中,创建相关表(注意修改表sql里的前缀razor_,以保持和你自己数据库中表前缀一致)。 | ||
- | |||
- | **1. 确保Cobub Razor与Cobub用户中心已成功授权绑定。**如未绑定,[[razor:plugins:start|请参见这里]]。 | ||
- | |||
- | **2.在Cobub Razor中激活个推应用并获取授权码** | ||
- | 若要使用个推插件中的推送,系统需要为每个App(当前只支持Android平台)分配相应的授权Key。 | ||
- | |||
- | **3.个推SDK集成** | ||
- | 注意:CobubRazor中必须使用从Cobub网站下载的SDK下载SDK才能使用插件的推送功能。 请不要到个推官方进行下载,也无需在个推注册帐号。 | ||
- | |||
- | 集成步骤: | ||
- | |||
- | 3.1.下载SDK。 | ||
- | |||
- | 请点击这里{{:razor:plugins:getui_sdk_v0.1.zip|下载}}。 | ||
- | |||
- | 3.2.将获取到的Cobub Razor的SDK和GexinSdk.jar添加到项目的libs目录。 | ||
- | |||
- | 3.3.在项目上右键选择Build Path->Configure build path…—>左侧选择 Java Build Path—>选择Libraries选择卡—>Add JARs.. —>选择当前项目的Libs目录,选中jar包,然后点击OK. | ||
- | |||
- | 3.4.配置AndroidManifest.xml文件。 | ||
- | * 添加授权 | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | * 加入服务声明 | ||
- | |||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | |||
- | |||
- | |||
- | | ||
- | | ||
- | | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | | ||
- | | ||
- | | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | |||
- | |||
- | |||
- | | ||
- | | ||
- | | ||
- | |||
- | |||
- | 注意:PACKAGENAME替换为项目包名. | ||
- | 其中的UMS_APPKEY、appid、appkey、appsecret是通过Cobub razor获取到的 | ||
- | |||
- | * 在程序入口Activity添加 如下红色部分 | ||
- | |||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | 3.5. 初始化SDK | ||
- | 在您应用程序主Activity里导入MessageManager如下所示: | ||
- | <code> | ||
- | import com.igexin.slavesdk.MessageManager;</code> | ||
- | 然后在您应用程序启动初始化阶段,初始化SDK: | ||
- | <code> | ||
- | MessageManager.getInstance().initialize(this.getApplicationContext());</code> | ||
- | 该方法必须在Activity或Service类内调用。一般情况下,可以在Activity的onCreate()方法中调用 | ||
- | 为保证意外情况导致初始化失败,建议应用程序每次启动时都调用一次该初始化接口。 | ||
- | |||
- | 3.6. 将 app_download_notification.xml 和 notification.xml (在 客户端/需导入的资源文件夹下)复制到工程res/layout/文件夹中,否则将不支持下载功能 和 自定义通知图标。 | ||
- | |||
- | MsgReceiver.java 用来获取内容如下 | ||
- | <code> | ||
- | package com.test; | ||
- | import android.content.BroadcastReceiver; | ||
- | import android.content.Context; | ||
- | import android.content.Intent; | ||
- | import android.os.Bundle; | ||
- | import android.util.Log; | ||
- | import com.igexin.sdk.Consts; | ||
- | public class MsgReceiver extends BroadcastReceiver { | ||
- | @Override | ||
- | public void onReceive(Context context, Intent intent) { | ||
- | Bundle bundle = intent.getExtras(); | ||
- | switch (bundle.getInt(Consts.CMD_ACTION)) { | ||
- | case Consts.GET_MSG_DATA: | ||
- | // 获取透传(payload)数据 | ||
- | byte[] payload = bundle.getByteArray("payload"); | ||
- | if (payload != null) { | ||
- | String data = new String(payload); | ||
- | Log.d("GexinSdkDemo", "Got Payload:" + data); | ||
- | // TODO:接收处理透传(payload)数据 | ||
- | } | ||
- | break; | ||
- | default: | ||
- | break; | ||
- | } | ||
- | } | ||
- | } | ||
- | </code> | ||
- | **4.使用个推推送服务** | ||
- | 进入Cobub Razor插件个推首页,插件会读取所有当前系统中的Android应用列表。 | ||
- | 在每个应用后都有推送和透传推送两个操作,用户可以根据自身需要进行选择消息类型。 | ||
- | 进入推送详细界面,根据要求选择标签或者整个APP推送,填写相关内容并进行推送 | ||
- | |||
- | **5.查看个推推送报告** | ||
- | 进入插件中的推送报告模块,用户可以查看用户推送的报告。注:系统只支持30日内推送报告查询服务。用户可通过右上角选择时间段。 | ||
- | 推送报告显示了所有激活的APP的推送报告,点击单个APP查看单个应用的推送报告。 | ||
- | |||
- | **6.账户与结算** | ||
- | 个推插件按月结算,系统会每个月根据用户上个月的用户所有APP在线用户总数来进行结算。 | ||
- | 个推插件的收费是按照当月在线人数结算,与推送次数无关。 | ||
- | 为保证推送服务正常进行,请到个人中心账户充值模块预先充值。 | ||
- | |||
- | **7.常见问题** | ||
- | |||
- | 什么是透传? | ||
- | 透传消息由推送服务器通过SDK传递给客户端,具体如何处理此消息由用户自己处理。(注:透传内容不支持转义字符) | ||
- | 客户端如何来实现并接收透传消息,请参见《个推SDK集成指南》 | ||
- | 为保证推送服务正常进行,请到个人中心账户充值模块预先充值。 | ||
- | |||
- | 如何获取Package Name? | ||
- | 应用标识(Package Name),常以com开头 | ||
- | 方法一: | ||
- | 安装并打开 包名检测工具 | ||
- | |||
- | 方法二: | ||
- | * 手机上打开你的应用 | ||
- | * 点击设置 -> 应用程序 -> 管理应用程序 -> 正在运行,在列表中找到你的程序 | ||
- | * 在进程中可以看到应用的应用标识(Package Name) |