通过 composer 安装
"require": {
"jpush/jpush": "v3.5.*"
}
然后运行 composer install
基本概念
platform 推送平台设置,目前支持 ios, android, winphone
audience 推送设备对象,表示一条推送可以被推送到哪些设备列表。确认推送设备对象,JPush 提供了多种方式,比如:别名、标签、注册ID、分群、广播等。
notification 通知内容体。是被推送到客户端的内容。与 message 一起二者必须有其一,可以二者并存。
message 应用内消息。或者称作:自定义消息,透传消息。是被推送到客户端的内容。与 notification 一起二者必须有其一,可以二者并存。
Push 接口
初始化
在 Laravel 中使用:
use JPush\Client as JPush;
$client = new JPush($app_key, $master_secret, $log_path);
$push = $client->push();
默认路径是 ./jpush.log,建议将 $log_path 指定为 null。
Platform
$push->setPlatform('all');
// OR
$push->setPlatform('ios', 'android');
// OR
$push->setPlatform(['ios', 'android']);
Audience
$push->addAllAudience();
$push->addTag('tag1');
// OR
$push->addTag(['tag1', 'tag2']);
其他诸如 addAlias(), addRegistrationId(), addTagAnd() 的使用方法与 addTag() 类似。
Notification
// 简单地给所有平台推送相同的 alert 消息
$push->setNotificationAlert('alert');
细分可以为 iOS Notification 、 Android Notification 、WinPhone Notification。
Message
// 调用示例
$push->message('Hello JPush');
options 推送可选项
apns_production 如果目标平台是 iOS,True 表示推送生产环境,False 表示要推送开发环境;
发送
$push->send();
资源
后话
最近使用极光推送给 APP 做系统消息,整理了在 Laravel 中的使用和基本概念。