iOS的推送可以用下图简单的概括:
这里 Provider 是指某个应用的Developer,当然如果开发者使用AVOS Cloud的服务,把发送消息的请求委托给我们,那么这里的Provider就是AVOS Cloud的推送服务程序了。上图可以分为三步:
第一步:AVOS Cloud推送服务程序把要发送的消息、目的设备的唯一标识打包,发给APNs。
第二步:APNs在自身的已注册Push服务的应用列表中,查找有相应标识的设备,并把消息发送到设备。
第三步:iOS系统把发来的消息传递给相应的应用程序,并且按照设定弹出Push通知
为了实现消息推送,有两点非常重要:
1. App的推送证书
要能够完整实现一条消息推送,需要我们在App ID中打开Push Notifications,需要我们准备好Provisioning Profile和SSL证书,并且一定要注意Development和Distribution环境是需要分开的。最后,把SSL证书导入到AVOS Cloud平台,就可以尝试远程消息推送了。具体的操作流程如下:
(1). 登录 iPhone Developer Connection Portal (链接) 然后点击 App IDs
(2). 创建一个 Apple ID ,如:com.chenjungang.apnstest 注意:通配符 ID 不能用于推送通知服务。
(3). 点击 Apple ID 旁的“Configure”,根据“向导” 的步骤生成一个签名上传,然后下载生成的许可证。
(4). 双击 .cer 文件将你的 aps_development.cer 导入 Keychain 中。
(5). 在 Mac 上打开“钥匙串访问”,然后在“登录”中选择 "密钥"分类,找到我们创建的证书,然后右击“Apple Development IOS Push Services: com.tadpole.TestAPNs” > 导出 “Apple Development IOS Push Services: com.tadpole.TestAPNs”。保存为 cert.p12 文件。
(6). 通过终端命令将这个 cert.p12 文件转换为 PEM 格式,打开终端, cd 进入证书所在目录,执行如下命令:(Java 直接给 .p12 文件,Php 给 pem 文件)
openssl pkcs12 -in cert.p12 -out apple_push_notification_production.pem -nodes -clcerts
执行完上面命令会在当前目录下生成一个名为apple_push_notification_production.pem文件,这个文件就是我们需要得到php连接APNS 的文件,将apple_push_notification_production.pem和push.php放入同一目录上传到服务器,push.php的代码如下:
1 <?php 2 $deviceToken = ‘ad853c20 3a9b874e 00d0cde2 44a73752 999bb250 9fa36129 0525d5d0 a6ba3e4c‘; 3 4 // Put your private key‘s passphrase here: 5 $passphrase = ‘123456‘; 6 7 // Put your alert message here: 8 $message = ‘This is some push message!‘; 9 $ctx = stream_context_create(); 10 stream_context_set_option($ctx, ‘ssl‘, ‘local_cert‘, ‘apple_push_notification_production.pem‘); 11 stream_context_set_option($ctx, ‘ssl‘, ‘passphrase‘, $passphrase); 12 13 // Open a connection to the APNS server 14 //这个为正式的发布地址 15 //$fp = stream_socket_client(“ssl://gateway.push.apple.com:2195“, $err, $errstr, 60, //STREAM_CLIENT_CONNECT, $ctx); 16 //这个是沙盒测试地址,发布到appstore后记得修改哦 17 $fp = stream_socket_client( 18 ‘ssl://gateway.sandbox.push.apple.com:2195‘, $err, 19 $errstr, 60, STREAM_CLIENT_CONNECT|STREAM_CLIENT_PERSISTENT, $ctx); 20 if (!$fp) 21 exit("Failed to connect: $err $errstr" . PHP_EOL); 22 echo ‘Connected to APNS‘ . PHP_EOL; 23 24 // Create the payload body 25 $body[‘aps‘] = array( 26 ‘alert‘ => $message, 27 ‘sound‘ => ‘default‘ 28 ); 29 30 // Encode the payload as JSON 31 $payload = json_encode($body); 32 33 // Build the binary notification 34 $msg = chr(0) . pack(‘n‘, 32) . pack(‘H*‘, $deviceToken) . pack(‘n‘, strlen($payload)) . $payload; 35 36 // Send it to the server 37 $result = fwrite($fp, $msg, strlen($msg)); 38 39 if (!$result) 40 echo ‘Message not delivered‘ . PHP_EOL; 41 else 42 echo ‘Message successfully delivered‘ . PHP_EOL; 43 44 // Close the connection to the server 45 fclose($fp); 46 47 ?>
PHP
2. 设备标识DeviceToken
知道了谁要推送,或者说要推送给哪个App之后,APNs还需要知道推到哪台设备上,这就是设备标识的作用。获取设备标识的流程如下:
第一步:App打开推送开关,用户要确认TA希望获得该App的推送消息
第二步:App获得一个DeviceToken
第三步:App将DeviceToken保存起来,这里就是通过[AVInstallation saveInBackground]将DeviceToken保存到AVOS Cloud
第四步:当某些特定事件发生,开发者委托AVOS Cloud来发送推送消息,这时候AVOS Cloud的推送服务器就会给APNs发送一则推送消息,APNs最后消息送到用户设备
推送相关的几个概念
消息类型
一条消息推送过来,可以有如下几种表现形式:
1. 显示一个alert或者banner,展现具体内容
2. 在应用icon上提示一个新到消息数
3. 播放一段声音
开发者可以在每次推送的时候设置,在推送达到用户设备时开发者也可以选择不同的提示方式。
本地消息通知
iOS上有两种消息通知,一种是本地消息(Local Notification),一种是远程消息(Push Notification,也叫Remote Notification),设计这两种通知的目的都是为了提醒用户,现在有些什么新鲜的事情发生了,吸引用户重新打开应用。
本地消息什么时候有用呢?譬如你正在做一个To-do的工具类应用,对于用户加入的每一个事项,都会有一个完成的时间点,用户可以要求这个To-do应用在事项过期之前的某一个时间点提醒一下TA。为了达到这一目的,App就可以调度一个本地通知,在时间点到了之后发出一个Alert消息或者其他提示。
我们在处理推送消息的时候,也可以综合运用这两种方式。
代码里面如何实现推送
首先,我们要获取DeviceToken。
App需要每次启动的时候都去注册远程通知——通过调用UIApplication的registerForRemoteNotificationTypes:方法,传递给它你希望支持的消息类型参数即可,例如:
1 #define IS_IOS8_AND_UP ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) 2 3 -(void)settingPushMessage:(UIApplication*)application 4 { 5 6 if (IS_IOS8_AND_UP) { 7 [application registerForRemoteNotifications]; 8 UIUserNotificationType types = UIUserNotificationTypeBadge|UIUserNotificationTypeSound|UIUserNotificationTypeAlert; 9 [application registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:types categories:nil]]; 10 }else{ 11 //消息推送支持的类型 12 UIRemoteNotificationType types = 13 (UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound); 14 //注册消息推送 15 [[UIApplication sharedApplication]registerForRemoteNotificationTypes:types]; 16 } 17 18 } 19 20 - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken 21 { 22 //获取token 23 NSString* token = [NSString stringWithFormat:@"%@",deviceToken]; 24 token = [token stringByReplacingOccurrencesOfString:@"<" withString:@""]; 25 token = [token stringByReplacingOccurrencesOfString:@">" withString:@""]; 26 [[NSUserDefaults standardUserDefaults] setObject:token forKey:@"APVNToken"]; 27 28 NSLog(@"token====%@",token); 29 } 30 - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error 31 { 32 //这里是获取token失败 33 NSString *error_str = [NSString stringWithFormat: @"%@", error]; 34 NSLog(@"Failed to get token, error:%@", error_str.description); 35 } 36 - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo 37 { 38 //在此处理接收到的消息。 39 NSLog(@"Receive remote notification : %@",userInfo); 40 }
请注意:注册流程需要在app每次启动时调用,这并不不会带来额外的负担,因为iOS操作系统在第一次获得了有效的device token之后,会本地缓存起来,以后app再调用registerForRemoteNotificationTypes:的时候会立刻返回,并不会再进行网络请求。另外,app层面不应该对device token进行缓存,因为device token也有可能变化——如果用户重装了操作系统,那么APNs再次给出的device token就会和之前的不一样,又或者是,用户restore了原来的backup到新的设备上,那么原来的device token也会失效。
其次,我们要处理收到消息之后的回调
我们可以设想一下消息通知的几种使用场景:
1,在app没有被启动的时候,接收到了消息通知。这时候操作系统会按照默认的方式来展现一个alert消息,在app icon上标记一个数字,甚至播放一段声音。
2,用户看到消息之后,点击了一下action按钮或者点击了应用图标。如果action按钮被点击了,系统会通过调用application:didFinishLaunchingWithOptions:这个代理方法来启动应用,并且会把notification的payload数据传递进去。如果应用图标被点击了,系统也一样会调用application:didFinishLaunchingWithOptions:这个代理方法来启动应用,唯一不同的是这时候启动参数里面不会有任何notification的信息。
3,如果远程消息发送过来的时候,app正在运行,这时候会发生什么呢?
app代理的application:didReceiveRemoteNotification:方法会被调用,同时远程消息中的payload数据会作为参数传递进去。
常见问题FAQ
1. 我能推送长消息吗?
不能,APNs限制了每个notification的payload最大长度是256字节,超长的消息是不能发送的。
2. 推送怎么加声音提醒?
消息推送是可以指定声音的。譬如你可以对正面的反馈使用欢快的声音,对负面的反馈使用低沉一点的声音,都可以达到别出心裁让人眼前一亮的目的。
你需要先放一些aiff、wav或者caf音频文件到app的资源文件中,然后在推送的时候指定不同的音频文件名就可以了。
3. 推送的Badge是怎么回事?
推送并不一定会导致应用图标上红色数字增加,是否显示这一数字,显示成多少,都取决于开发者自己。
在发送推送消息的时候,我们可以选择是否递增这一数字;如果不选择这一项,那么消息推送并不会导致应用图标上红色数字的出现。
好,现在问题来了,这个数字如果搞出来了,怎么让它消失掉呢?
其实我们只需要在任何时候设置 UIApplication.applicationIconBadgeNumber 属性为0,就可以让这个数字消失掉。
一般我们会选择在应用启动的时候(application:didFinishLaunchingWithOptions:方法中),或者干脆一点,在应用每次被切换到前台的时候(applicationWillEnterForeground:方法中),调用这一行代码,即可立刻清除掉Badge数字了。
4. AVOS Cloud平台发出去的通知格式究竟是什么样子的
对于每一条推送消息,都包含一个payload,通常是组成了一个JSON的Dictionary,这其中必不可少的是aps属性,它对应的value也是一个Dictionary,包含下面一些内容:
1)alert消息(文本或Dictionary)
2)应用图标上的红色数字
3)播放的声音文件名
在由推送激活的app打开事件中,application:didFinishLaunchingWithOptions:的options参数就是这个大的Dictionary对象。
1 { 2 aps = { 3 alert = "hello, everyone"; 4 badge = 2; 5 sound = default; 6 }; 7 }
这里要注意的时alert部分,它的值可以是一个String(文本消息),也可以是一个JSON的Dictionary。当它是文本消息的时候,系统就会把这些文字显示到一个alertview中;如果它也是由一个JSON Dictionary组成的话,其格式如下:
* body
* action-loc-key
* loc-key
* loc-args
* launch-image
body部分就是alertView中将要展现出来的文本消息,loc-属性主要是用来实现本地化消息,launch-image只是app主bundle里的一个图片文件的名称,一般来说我们不指定这一属性。
5. 如何显示本地化的消息
有两种办法可以实现推送消息的本地化:
1)在推送的payload中使用loc-key和loc-args来指定进行本地化,这样Provider方只需要按照统一的格式来发送即可,消息的解析和组装则由客户端来完成。
2)如果推送的payload里面不包含loc-key/loc-args信息,那么Provider方就需要自己做本地化处理,然后给不同的device发送不同的消息,为了做到这一点,还需要app在上传device token的时候也把用户的语言设置信息传回来。
目前,因为AVOS Cloud主要就是瞄准中国大陆市场和海外中文用户,所以我们在推送上还不提供多语言支持。
6. 应用该怎么响应推送消息
上面说的处理流程,只能简单展示一下远程消息,激活用户让他们重新回到app中来。但是有时候,我们希望带给用户更好的使用体验,譬如如果我们告诉用户:张三刚刚评论了你的照片。这时候用户如果点击action按钮进入app,我们是展示具体的评论页面为好,还是展示通常的启动页面然后让用户自己去找张三的评论好?我想负责任的开发者都会选择前者。
要做到灵活响应不同类型的通知消息,我们需要在通知的payload中增加更多信息,而不能仅仅只有alert出来的文字信息。对于AVOS Cloud消息推送平台来讲,就需要开发者使用更高级功能的JSON格式。譬如我们发送这样的json字符串{"action":{"type":4},"alert":"hello, everyone”} 最终在app内会收到这样的UserInfo Dictionary:
1 { 2 action = { 3 type = 4; 4 }; 5 aps = { 6 alert = "hello, everyone"; 7 badge = 4; 8 }; 9 }
“hello, everyone”会显示到alertView中,但是整个Dictionary会通过launchOptions传递给application: didFinishLaunchingWithOptions: 方法,这样我们在程序里面就可以对不同的消息实现不同的跳转了。