# 消息推送
# APNs推送
# 配置证书
详细的证书制作及上传请参考文档:制作推送证书并在管理后台配置 。
# 注册推送服务
需在 App 启动时注册推送服务:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
...
//注册 APNS
if ([[[UIDevice currentDevice] systemVersion] doubleValue] >= 10.0) {
[UNUserNotificationCenter currentNotificationCenter].delegate = self;
UIUserNotificationType types = UNAuthorizationOptionAlert | UNAuthorizationOptionBadge | UNAuthorizationOptionSound;
[[UNUserNotificationCenter currentNotificationCenter] requestAuthorizationWithOptions:types completionHandler:nil];
[[UIApplication sharedApplication] registerForRemoteNotifications];
} else if ([[[UIDevice currentDevice] systemVersion] doubleValue] >= 8.0) {
UIUserNotificationType types = UIUserNotificationTypeAlert | UIUserNotificationTypeBadge | UIUserNotificationTypeSound;
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
[[UIApplication sharedApplication] registerForRemoteNotifications];
} else {
UIRemoteNotificationType types = UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeSound | UIRemoteNotificationTypeBadge;
[[UIApplication sharedApplication] registerForRemoteNotificationTypes:types];
}
...
}
注意 iOS10 及以上系统推送相关 API 变化较大,可分系统做注册处理。
获取到设备的 DeviceToken 后,传给 SDK:
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
...
[[QYSDK sharedSDK] updateApnsToken:deviceToken];
...
}
# 常见问题
无法正常推送
检查管理端 App接入 中是否配置过推送证书 p12 文件,此证书是否就是此 App bundleID 关联的推送证书。
检查初始化时填的 AppName 是否和管理端 添加一个App 时填写的 App名称 一致。
检查证书的线上、测试环境是否跟管理后台配置的相同。请注意,若您想同时在 Debug 包和 Release 包中均接收推送消息,应添加两个 App,分别填入不同的名称并上传线上环境和测试环境的证书,同时在注册 AppKey 的地方这样写代码:
#if DEBUG [[QYSDK sharedSDK] registerAppId:Appkey appName:Debug包App名称]; #else [[QYSDK sharedSDK] registerAppId:Appkey appName:Release包App名称]; #endif
检查 provision profile 是否包含了推送证书。
检查推送证书中是否有 p12 文件。
检查代码调试是否可以获取到 DeviceToken。
使用第三方推送工具(例如 Pusher )检查是否可以正常推送,如果不能,说明可能是证书本身的问题。
可以同时使用第三方推送工具吗
- 可以同时使用第三方推送工具和 SDK 的消息推送,两者可以共存,不会有任何冲突。
# 使用七鱼回调实现前台推送
APP在后台或者被杀死的情况下,客服发送给访客的消息,会通过APNS推送送达手机;APP处于前台激活状态下,APNS不再推送消息,此时可以使用以下回调方法处理: 1、先设置delegate
[[[QYSDK sharedSDK] conversationManager] setDelegate:self];
2、实现协议方法
/**
* 接收消息
*/
- (void)onReceiveMessage:(QYMessageInfo *)message;
# 七鱼系统推送
七鱼系统推送与苹果的 APNs 推送无关,开发可通过注册推送消息通知回调,获取七鱼推送的消息:
/**
* 推送消息回调
*/
typedef void(^QYPushMessageBlock)(QYPushMessage *pushMessage);
/**
* 注册推送消息通知回调
*
* @param block 收到消息的回调
*/
- (void)registerPushMessageNotification:(QYPushMessageBlock)block;
收到服务器返回的消息后,前端可进行自定义界面展示;无论是主动获取的消息还是管理后台主动推送的消息,均采用统一接口回调。