小米推送服务iOS客户端SDK使用指南

最新推荐文章于 2024-05-09 12:01:14 发布
最新推荐文章于 2024-05-09 12:01:14 发布
阅读量6.5k 收藏
点赞数 2
分类专栏： 推送 iOS
iOS 同时被 2 个专栏收录
252 篇文章 1 订阅
订阅专栏
推送
4 篇文章 0 订阅
订阅专栏

如果您在集成过程中遇到任何问题，都可以添加QQ群：385428920 ，群中会有工程师解答您的问题。

小米推送iOS版提供存量用户无缝迁移方案
小米推送现已支持批量导入DeviceToken的功能，可以帮助您将IOS推送无缝迁移到小米推送服务上。

迁移方法是给我们提供所有现有设备的DeviceToken列表（CSV或TXT格式，每行一个DeviceToken），我们会为这拨设备直接生成小米推送的设备标识（regid），这样即使这批用户不升级到包含小米推送SDK的应用新版本也依然能收到通过小米推送服务发出的消息。

如有迁移需求，请在集成小米推送的应用版本正式发布前联系我们进行导入。
联系方式：
马一翔 mayixiang@xiaomi.com
赵宇斌 zhaoyubin@xiaomi.com

修订历史
  2014年3月 草稿
  2014年4月 正式版
  2014年9月 Add 常见问题
  2015年5月 Add 应用内长连接
  在集成过程中遇到任何问题，请联系我们：DevPush@xiaomi.com

目录

1. 概要 2. 使用说明
2.1. 创建APNs证书 2.2. 搭建XCode运行环境 2.3. 配置SDK运行参数 2.4. 注册推送服务，绑定手机设备 2.5. 实现MiPushSDKDelegate回调 2.6. 长连接消息处理 2.7. 别名Alias / 订阅Topic / 帐号Account 2.8. 解析消息，并记录开启事件 2.9. iOS8推送消息快速回复 2.10. 开发环境/生产环境之间的切换
3. API说明
3.1. @interface MiPushSDK : NSObject 3.2. @protocol MiPushSDKDelegate <NSObject> 3.3. 方法详细说明 3.4. 错误码说明
4. 常见问题
4.1. 收不到推送消息？ 4.2. 接入时碰到如下提示 4.3. 常见返回错误 4.4. 脚标或通知栏无法清除？ 4.5. SetAlias Subscribe为什么有时成功，有时失败？ 4.6. 接收到推送之后 如何取得里面的数据？ 4.7. registerMiPush 在没有网络下调用，为什么还会返回成功？ 4.8. Topic 最多可以设置多少个，支持汉字吗？ 4.9. 如何使用 iOS7 Background Remote Notification (消息透传) 4.10. 为什么要使用长连接 4.11. 在现有版本MiPushSDK下，如何快速使用应用内长连接

1. 概要

iOS版本包括两部分。

1. 基于Apple的APNs(Apple Push Notification Service)

2.
应用内长连接(即在App启动并运行在前台时，SDK内部会运行一个Socket长连接连接到Server端，以接收消息推送。此长连接跟APNs时分开的，不经过APNs服务器)

SDK以.a动态链接库的形式提供， 开发者只需在原有编码基础上添加少许代码，来注册小米推送服务与绑定手机设备。

客户端在注册成功后，会得到服务器颁发的regId(终端唯一标示)，服务端通过regId发消息给终端。
除此以外，客户端还可以通过订阅Topic、设置别名Alias、帐号Acount来收发推送消息。

2. 使用说明

这里介绍如何配置和使用小米推送服务，您也可以参照Demo来配置和使用小米推送服务。

在使用小米推送服务前，开发者需要先登录小米开发者网站http://developer.xiaomi.com。注册App，申请对应的AppID, AppKey,
AppSecret。

其中AppID和AppKey是客户端的应用标识，在客户端SDK初始化时使用；AppSecret是应用私钥，在使用服务器 SDK向客户端发送消息时使用。

2.1. 创建APNs证书

APNs证书是一种扩展名为p12的文件，它是我们发送消息给APNs的证明。在开发时我们分Development环境与Distribution环境。所以p12会有两个版本：Development
与 Distribution。NOTE: 创建证书时请携带密码。

1.在Mac中，开启Keychina Access
2.选中你对应bundleID 的证书，注意 Development/Distribution。右键Export

3.Save。注意文件格式

4.保存时需要你给证书设定密码

2.2. 搭建XCode运行环境

我们的libMiPushSDK库文件同时包含i386、x86_64、arm64、armv6和armv7的代码，所以libMiPushSDK将同时支持真机与模拟器。但由于Apple推送不支持模拟器，请使用真机测试功能。

  1. 小米推送服务IOS版支持的最低系统版本iOS5.0
  2. 添加libMiPushSDK.a , MiPushSDK.h 到工程
  3. 引入库 libresolv.dylib, libxml2.dylib, libz.dylib,
    SystemConfiguration.framework，MobileCoreServices.framework，CFNetwork.framework，CoreTelephony.framework
    (如果已经引入,请忽略)

2.3. 配置SDK运行参数

运行SDK注册小米推送服务的时候，需要使用AppID，AppKey，等参数来验证使用者的合法性。

  1. 打开工程下资源文件Info.plist
  2. 文件为源代码形式打开，添加以下信息 
    <dict>
	<key>MiSDKAppID</key>
	<string>1000888</string>
	<key>MiSDKAppKey</key>
	<string>500088888888</string>
	<key>MiSDKRun</key>
	<string>Online</string>
</dict>
  3. 如果开发版本较多，修改连接环境比较繁琐，提供以下方式。 
    !--请注意MiSDKRun写法, 用buildSetting里面的宏替换--
<dict>
	<key>MiSDKAppID</key>
	<string>1000888</string>
	<key>MiSDKAppKey</key>
	<string>500088888888</string>
	<key>MiSDKRun</key>
	<string>${MiSDKRun}</string>
</dict>
  4. MiSDKAppID, MiSDKAppKey 为在小米开发者网站http://developer.xiaomi.com。注册App，申请的AppID,
    AppKeyMiSDKRun 是设定SDK是连接Development环境/Distribution环境 对应参数为Debug/Online

2.4. 注册推送服务，绑定手机设备

工作流程：

  1. 当客户端应用启动时，调用以下代码注册推送服务注册时需要设置MiPushSDKDelegate 
    // 只启动APNs.
 [MiPushSDK registerMiPush:self];
    // 同时启用APNs跟应用内长连接
 [MiPushSDK registerMiPush:self type:0 connect:YES];
  2. 推送服务注册成功后，SDK会请求APNs建立连接并获得deviceToken，请求获得deviceToken成功后请调用以下代码来绑定手机设备 
     #pragma mark UIApplicationDelegate
 - (void)application:(UIApplication *)app 
         didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
 {
    // 注册APNS成功, 注册deviceToken
    [MiPushSDK bindDeviceToken:deviceToken];
 }

 - (void)application:(UIApplication *)app 
         didFailToRegisterForRemoteNotificationsWithError:(NSError *)err
 {
    // 注册APNS失败
    // 自行处理
 }

2.5. 实现MiPushSDKDelegate回调

SDK中所有请求操作都是异步的。调用成功与失败都会通过MiPushSDKDelegate来通知。
其中包括：注册小米推送，绑定deviceToken，设置Alias，订阅Topic，帐号Account，App统计打点等。

  1. 在AppDelegate.h中加入MiPushDelegate协议 
     #import "MiPushSDK.h"

     // <--

 @interface MPAppDelegate : UIResponder
 
<
    MiPushSDKDelegate,      // <--
    UIApplicationDelegate

 >
 @property (strong, nonatomic) UIWindow *window;
  
 @end
  2. 在AppDelegate.m中实现回调方法 
     #pragma mark MiPushSDKDelegate
  
 - (void)miPushRequestSuccWithSelector:(NSString *)selector data:(NSDictionary *)data
 {
      // 请求成功
 }
  
 - (void)miPushRequestErrWithSelector:(NSString *)selector error:(int)error data:(NSDictionary *)data
 {
      // 请求失败
 }

2.6. 长连接消息处理

当App启动并运行在前台时，SDK内部会运行一个Socket长连接连接到Server端，以接收消息推送。收到消息时回通过MiPushSDKDelegate来通知

  1. 在AppDelegate.m中实现回调方法 
     - ( void )miPushReceiveNotification:( NSDictionary *)data
 {
     // 长连接收到的消息。消息格式跟APNs格式一样
 }
  2. 同一条消息
    会通过APNs跟长连接分别收到。所以需要使用下面代码把APNs消息导入到SDK内部进行去重复。 

     - ( void )application:( UIApplication *)application didReceiveRemoteNotification:( NSDictionary *)userInfo
 {
     [ MiPushSDK handleReceiveRemoteNotification :userInfo];
     // 使用此方法后，所有消息会进行去重，然后通过miPushReceiveNotification:回调返回给App
 }

2.7. 别名Alias / 订阅Topic / 帐号Account

注册推送服务，绑定手机设备成功后，即可调用以下方法

 // 设置别名           
 [MiPushSDK setAlias:@“alias”]
  
 // 订阅内容
 [MiPushSDK subscribe:@“topic”] 

 // 设置帐号
 [MiPushSDK setAccount:@“account”]

Alias可以理解为regId的别名，开发者可以将alias设置为自己应用帐号系统的帐号，或者设备标识等。然后在使用ServerSDK发送消息的时候，即可直接指定发送给特定的alias，而不是regId，避免存储regId。

主题用来做广播消息。不同手机上的同一个App可以订阅同一个主题。通过发送主题消息的API，即可同时向所有订阅该主题的客户端发送消息。比如，您有一个新闻类的App，可以自定义“财经”、“体育”、“科技“等主题；对于经常阅读财经新闻的用户，您可以帮用户订阅“财经”类主题，当有新的财经要闻发生时，直接通过主题推送该新闻给所有订阅该主题的用户。

帐号，多设备设置同一个帐号, 发送消息时多设备可以同时收到。一般在多点登陆时使用，多设备使用同一个帐号，他们可以同时收到消息。

2.8. 解析消息，并记录开启事件

注：当启用长连接时，不需要在进行此操作。

当App工作在前台或后台，收到推送消息后，请实现下面代码，已统计用户开启App事件。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    ......
    [MiPushSDK registerMiPush:self type:0 connect:YES];
    NSString *messageId = [userInfo objectForKey:@"_id_"];
    if (messageId!=nil) {
      [MiPushSDK openAppNotify:messageId];
    }
    ......
}
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
{
    NSString *messageId = [userInfo objectForKey:@"_id_"];
    [MiPushSDK openAppNotify:messageId];
}

当iOS7
你使用RemoteNotification时，请实现下面代码

- (void)application:(UIApplication *)application 
    didReceiveRemoteNotification:(NSDictionary *)userInfo 
    fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler
{
    NSString *messageId = [userInfo objectForKey:@"_id_"];
    [MiPushSDK openAppNotify:messageId];
}

2.9. iOS8推送消息快速回复

当用户收到消息的时候，提供一个快速回复的按钮。具体信息可参考

https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/IPhoneOSClientImp.html

#pragma mark MiPushSDKDelegate
- (void)miPushRequestSuccWithSelector:(NSString *)selector data:(NSDictionary *)data
{    
    ...
    if ([selector isEqualToString:@"bindDeviceToken:"]) {
        
        UIMutableUserNotificationAction *action = [[UIMutableUserNotificationAction alloc] init];
        action.identifier = @"action1"; //按钮的标示
        action.title=@"启动"; //按钮的标题
        action.activationMode = UIUserNotificationActivationModeForeground;//当点击的时候启动程序
        
        UIMutableUserNotificationAction *action2 = [[UIMutableUserNotificationAction alloc] init];
        action2.identifier = @"action2";
        action2.title=@"忽略";
        action2.activationMode = UIUserNotificationActivationModeBackground;//当点击的时候不启动程序，在后台处理
        action.authenticationRequired = YES;//需要解锁才能处理
        action.destructive = YES;
        
        UIMutableUserNotificationCategory *categorys = [[UIMutableUserNotificationCategory alloc] init];
        categorys.identifier = @"category"; //这组动作的唯一标示
        [categorys setActions:@[action,action2] forContext:(UIUserNotificationActionContextMinimal)];
        
        UIUserNotificationSettings *uns = [UIUserNotificationSettings settingsForTypes:
                  (UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound)
                  categories:[NSSet setWithObjects:categorys, nil]];
        [[UIApplication sharedApplication] registerUserNotificationSettings:uns];
    }
}

2.10. 开发环境/生产环境之间的切换

为了方便开发调试，除了Distribution服务器外，我们还提供Development服务器。为了避免影响已发布的App，您可以在Development服务器上开发调试，开发完毕再切换到Distribution服务器。

Apple签名APNs证书也分Development/Distribution。并且终端应用在不同环境下获得的deviceToken也不同。

开启Info.plist文件，修改MiSDKRun参数。Debug：Development服务器。Online：Distribution服务器

3. API说明

MiPushSDK.h 分两部分 @interface MiPushSDK ，@protocol MiPushSDKDelegate

3.1. @interface MiPushSDK : NSObject

MiPushSDK是小米推送服务在iOS平台的接入类。单实例。并提供了一系列静态方法。

表 1. 

API 功能 使用场景
+ (void)registerMiPush:(id<MiPushSDKDelegate>)delegate 客户端注册设备 由开发者选择注册MiPushSDK时机。建议在程序启动时调用此方法
+ (void)registerMiPush:(id<MiPushSDKDelegate>)delegate type:(UIRemoteNotificationType)type 客户端注册设备，并设置消息类型 由开发者选择注册MiPushSDK时机。建议在程序启动时调用此方法
+ (void)registerMiPush:(id<MiPushSDKDelegate>)delegate type:(UIRemoteNotificationType)type connect:(BOOL)connect; 客户端注册设备，并设置消息类型与是否使用长连接 由开发者选择注册MiPushSDK时机。建议在程序启动时调用此方法
+ (void)unregisterMiPush 客户端设备注销 当App选择停止推送功能的时候调用此方法。
+ (void)bindDeviceToken:(NSData *)deviceToken 绑定 PushDeviceToken 代码必须写在如下方法里。 – (void)application:(UIApplication *)app
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
+ (void)setAlias:(NSString *)alias 为指定用户设置别名 在成功注册设备并绑定DeviceToken后调用
+ (void)unsetAlias:(NSString *)alias 取消指定用户的别名 在成功注册设备并绑定DeviceToken后调用
+ (void)setAccount:(NSString *)account 为指定用户设置帐号 在成功注册设备并绑定DeviceToken后调用
+ (void)unsetAccount:(NSString *)account 取消指定用户的帐号 在成功注册设备并绑定DeviceToken后调用
+ (void)subscribe:(NSString *)topic 为某个用户设置订阅主题 在成功注册设备并绑定DeviceToken后调用
+ (void)unsubscribe:(NSString *)topic 取消某个用户的订阅主题 在成功注册设备并绑定DeviceToken后调用
+ (void)getAllAliasAsync 获取客户端设置的别名。 在成功注册设备并绑定DeviceToken后调用
+ (void)getAllTopicAsync 获取客户端订阅的主题。 在成功注册设备并绑定DeviceToken后调用
+ (void)getAllAccountAsync 获取客户端订阅的帐号。 在成功注册设备并绑定DeviceToken后调用
+ (void)openAppNotify:(NSString *)messageId 统计客户端通过推送，而开启App的行为。 在成功注册设备并绑定DeviceToken后调用
+ (NSString*)getSDKVersion 获取SDK版本号。  

 

3.2. @protocol MiPushSDKDelegate <NSObject>

MiPushSDKDelegate SDK的所有请求都是异步操作，用户需监听此方法。

表 2. 

API 功能
- (void)miPushRequestSuccWithSelector:(NSString *)selector data:(NSDictionary
*)data		 当请求成功时返回
- (void)miPushRequestErrWithSelector:(NSString *)selector error:(int)error
data:(NSDictionary *)data		 当请求失败时返回

 

3.3. 方法详细说明

3.3.1. + (void)registerMiPush:(id<MiPushSDKDelegate>)delegate;

建议在程序启动时调用此方法，代码放到以下代码块中。这是因为，如果用户重装了iOS或者用户换了设备并且恢复程序备份到一个新的设备，都将导致这个token值不一样。

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

表 3. 

参数列表 参数说明
(id<MiPushSDKDelegate>)delegate 加入请求成功与失败的监听

 

3.3.2. + (void)registerMiPush:(id<MiPushSDKDelegate>)delegate type:(UIRemoteNotificationType)type;

建议在程序启动时调用此方法，代码放到以下代码块中。这是因为，如果用户重装了iOS或者用户换了设备并且恢复程序备份到一个新的设备，都将导致这个token值不一样。

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

表 4. 

参数列表 参数说明
(id<MiPushSDKDelegate>)delegate 加入请求成功与失败的监听
type:(UIRemoteNotificationType)type 消息类型:UIRemoteNotificationTypeBadge, UIRemoteNotificationTypeSound, UIRemoteNotificationTypeAlert, UIRemoteNotificationTypeNewsstandContentAvailability

 

3.3.3. + (void)registerMiPush:(id<MiPushSDKDelegate>)delegate type:(UIRemoteNotificationType)type connect:(BOOL)connect;

建议在程序启动时调用此方法，代码放到以下代码块中。这是因为，如果用户重装了iOS或者用户换了设备并且恢复程序备份到一个新的设备，都将导致这个token值不一样。

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

表 5. 

参数列表 参数说明
(id<MiPushSDKDelegate>)delegate 加入请求成功与失败的监听
type:(UIRemoteNotificationType)type 消息类型:UIRemoteNotificationTypeBadge, UIRemoteNotificationTypeSound, UIRemoteNotificationTypeAlert, UIRemoteNotificationTypeNewsstandContentAvailability
connect:(BOOL)connect 是否启动应用内长连接

 

3.3.4. + (void)unregisterMiPush;

当客户端决定关闭推送功能的时候调用此方法。并且需要注意，在下次程序启动的时候不要调用registerMiPush:。否则推送又将被开启

小米推送服务关闭后，在调用其他功能性API都将提示错误。

3.3.5. + (void)bindDeviceToken:(NSData *)deviceToken

向MiPush注册deviceToken。为保证消息可达，必须在系统application:didRegisterForRemoteNotificationsWithDeviceToken:调用。SDK内部会处理是否重新同步上传

表 6. 

参数列表 参数说明
(NSData *)deviceToken 设备的唯一标示，有Apple分配。
application:didRegisterForRemoteNotificationsWithDeviceToken: 返回的内容.

 

3.3.6. + (void)setAlias:(NSString *)alias;

开发者可以为指定用户设置别名，然后给这个别名推送消息，效果等同于给regId推送消息。注:
一个regId可以被设置多个别名，如果设置的别名已经存在，会覆盖掉之前的别名。不要超过100个

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

表 7. 

参数列表 参数说明
(NSString *)alias 为指定用户设置别名

 

3.3.7. + (void)unsetAlias:(NSString *)alias

开发者可以取消指定用户的某个别名，服务器就不会给这个别名推送消息了。

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

表 8. 

参数列表 参数说明
(NSString *)alias 为指定用户设置别名

 

3.3.8. + (void)setAccount:(NSString *)account;

开发者可以为指定用户设置帐号，然后给这个帐号推送消息，效果等同于给regId推送消息。注: 一个regId可以被设置多个帐号。不要超过100个

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

表 9. 

参数列表 参数说明
(NSString *)account 为指定用户设置帐号

 

3.3.9. + (void)unsetAccount:(NSString *)account;

开发者可以取消指定用户的某个帐号，服务器就不会给这个帐号推送消息了。

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

表 10. 

参数列表 参数说明
(NSString *)account 为指定用户设置帐号

 

3.3.10. + (void)subscribe:(NSString *)topic

为某个用户设置订阅主题；根据用户订阅的不同主题，开发者可以根据订阅的主题实现分组群发。

支持同时设置多个topic, 中间使用”,”分隔

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

表 11. 

参数列表 参数说明
(NSString *)topic 某个用户订阅的主题

 

3.3.11. + (void)unsubscribe:(NSString *)topic

为某个用户取消某个订阅主题。

支持同时设置多个topic, 中间使用”,”分隔

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

表 12. 

参数列表 参数说明
(NSString *)topic 某个用户取消订阅的主题

 

3.3.12. + (void)openAppNotify:(NSString *)messageId

统计客户端，通过推送开启App行为。如果你想使用MiPush服务器帮你统计点击量 请自行调用此方法。然后登陆推送后台推送统计查看数据。

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

表 13. 

参数列表 参数说明
(NSString *)messageId 每条通知都会有一条唯一索引, 保存在Payload里面的miid。统计时需要携带此参数。以作为消息跟踪

 

3.3.13. + (void)getAllAliasAsync

获取客户端设置的别名列表。

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

3.3.14. + (void)getAllAccountAsync;

获取客户端设置的帐号列表。

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

3.3.15. + (void)getAllTopicAsync;

获取客户端订阅的主题列表。

在成功注册设备并绑定DeviceToken后调用，当关闭推送功能后再调用此方法将会失败

3.3.16. + (NSString*)getSDKVersion

获取SDK版本号

3.3.17. - (void)miPushRequestSuccWithSelector:(NSString *)selector data:(NSDictionary
*)data

当请求成功后，会回调此方法

表 14. 

参数列表 参数说明
(NSString *)selector 请求调用方法的名称。例: “setAlias:”
(NSDictionary *)data 请求后下发的服务器信息。

 

3.3.18. - (void)miPushRequestErrWithSelector:(NSString *)selector error:(int)error
data:(NSDictionary *)data

当请求失败后，会回调此方法

表 15. 

参数列表 参数说明
(NSString *)selector 请求调用方法的名称。例: “setAlias:” NOTE: 最后参数后面的冒号
(int)error 错误码。参加“错误码说明”
(NSDictionary *)data 请求后下发的服务器信息。

 

3.4. 错误码说明

表 16. 

错误码 说明
-1 访问超时，网络信号不好
-2 无网络
-3 未知错误，通常意味着MiPush服务器的业务错误
-4 操作太频繁
-5 请求无效参数
-6 返回结果无效
-100 无效的UserID
-101 无效的RegID

 

4. 常见问题

4.1. 收不到推送消息？

请检查以下几点

  1. 开发者网站是否启用推送服务，并成功上传证书
  2. 用Appsecret自行推送的，请确认此secret是否为iOS版本，
  3. 工程里面plist中MiSDKRun环境参数是否设置妥当。debug为测试环境，online为线上环境
  4. 必须真机调试，IPA的profile是否与push证书匹配。
  5. 代码中监听MiPushSDKDelegate，看注册与绑定token是否正常，alias，topic是否设置成功

4.2. 接入时碰到如下提示

Error is Error Domain=NSCocoaErrorDomain Code=3000 "未找到应用程序的“aps-environment”的授权字符串"
        UserInfo=0x17dbf200 {NSLocalizedDescription=未找到应用程序的“aps-environment”的授权字符串}

检查事项 同4.1

4.3. 常见返回错误

  1. 调用SDK + (void)unregisterMiPush; 执行注销操作后，在执行其他方法就会导致报错－101
  2. 你的程序清除本地数据。NSUserDefaults导致本地保存的regID等丢失。就会导致报错－101
  3. 解决方法：当回调返回-101时，根据你程序需要，可以重新调用+ (void)registerMiPush
  4. code=10017; reason=’invalid package name’ 小米开发者网站 注册的bundleID 跟 你ipa的bundleID
    不是同一个

4.4. 脚标或通知栏无法清除？

清除方法：

[[UIApplication sharedApplication] setApplicationIconBadgeNumber:0];

如果无效请尝试，原因是，在推送时badge设置为0，这样你在app中再次设置就会失效

[[UIApplication sharedApplication] setApplicationIconBadgeNumber:1];
[[UIApplication sharedApplication] setApplicationIconBadgeNumber:0];

4.5. SetAlias Subscribe为什么有时成功，有时失败？

SDK中方法为异步操作，setAlias: subscribe:等操作必须在bindDeviceToken:返回成功后再调用。

因为bindDeviceToken成功请求后服务器才会分配账号给设备。如果setAlias操作在它前面执行，会找不到对应设备。

4.6. 接收到推送之后 如何取得里面的数据？

当App在后台，通过下面方法

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo

当新App的时候，通过下面方法

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

4.7. registerMiPush 在没有网络下调用，为什么还会返回成功？

SDK中会检查，如果此操作已经完成过，就不会重复请求服务器。

4.8. Topic 最多可以设置多少个，支持汉字吗？

一个设备最多可以设置300个, 支持汉字。

4.9. 如何使用 iOS7 Background Remote Notification (消息透传)

App在后台，收到消息后，会在后台运行一段代码。并不会提示用户。比如，App内容升级，Email更新，订阅内容等等

在server端发送消息时extra加入content-available字段。同时xcode工程下激活BackgroundModes-Remote notifications。

4.10. 为什么要使用长连接

在App运行时 ，APNs会提示用户是否接收消息，很多时候，用户会禁止此功能。导致，推送消息无法送达到用户手机。所以使用长连接功能，可以在App运行时，获取消息推送。

4.11. 在现有版本MiPushSDK下，如何快速使用应用内长连接

操作步骤：

1. 添加libMiPushSDK.a , MiPushSDK.h 到工程
2. 引入库：libresolv.dylib, libxml2.dylib, libz.dylib, SystemConfiguration.framework，MobileCoreServices.framework，CFNetwork.framework，CoreTelephony.framework (如果已经引入,请忽略)
3. 加入如下代码, 启动长连接
+ (void)registerMiPush:(id<MiPushSDKDelegate>)delegate type:(UIRemoteNotificationType)type connect:(BOOL)connect;
4. 加入收到消息回调，当客户端收到MiPush推送时，此方法会被调用到，data格式同 application:didReceiveRemoteNotification:
- (void)miPushReceiveNotification:(NSDictionary*)data;
5. 去掉原有处理通知逻辑，使用下面代替
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
{
    [MiPushSDK handleReceiveRemoteNotification:userInfo];
}
Vic__li
关注
  • 2
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
小米 app消息推送服务器,APP使用小米消息推送自定义铃声iOS版
weixin_39843698的博客
07-30 819
正 文：APP使用小米消息推送sdk的情况下，怎么自定义铃声呢？项目场景是利用Hbuilder云端打包iOS版，我们拿到手的是云端打包好的.ipa文件，和Hbuilder技术沟通，得到明确的答复是云端打包不支持添加自定义的声音资源到ipa包里去，只能离线打包。看来Hbuilder还是任重而道远啊，有很多技术细节还要不断完善。自定义通知声音需要满足以下条件：1. 声音文件必须放在app bundle...
基于ffmpeg与nvidia-video-sdk-8.1.24视频硬解与软解多路rtsp，支持Qt的QOpenglWidget与qml接口显示
mengzhengjie的专栏
05-14 807
https://blog.csdn.net/wanghualin033/article/details/82050448 为了解决工程上的一个问题，我研究了nvidia较新的video-sdk-8.1.24,看完之后觉得这个sdk比较符合现代的编程规范，于是摒弃了以前的video-sdk-6.0，解决了工程上的问题。 我提供的封装支持软解和硬解，其中重要部分为做了视...
Android最全Android 小米推送服务集成(1)，2024年最新如何化身BAT面试收割机
最新发布
2401_84562529的博客
05-09 314
这里我特地整理了一份《Android开发核心知识点笔记》，里面就包含了自定义View相关的内容除了这份笔记，还给大家分享Android学习PDF+架构视频+面试文档+源码笔记，高级架构技术进阶脑图、Android开发面试专题资料，高级进阶架构资料这几块的内容。非常适合近期有面试和想在技术道路上继续精进的朋友。分享上面这些资源，希望可以帮助到大家提升进阶，如果你觉得还算有用的话，不妨把它们推荐给你的朋友~喜欢本文的话，给我点个小赞、评论区留言或者转发支持一下呗~
Android消息推送：手把手教你集成小米推送
热门推荐
Carson带你学Android
12-15 2万+
前言 在Android开发中，消息推送功能的使用非常常见。为了降低开发成本，使用第三方推送是现今较为流行的解决方案。 今天，我将手把手教大家如何在你的应用里集成小米推送 该文档基于小米推送官方Demo，并给出简易推送Demo 看该文档前，请先阅读我写的另外两篇文章： 史上最全解析Android消息推送解决方案 Android推送：第三方消息推送平台详细解析目录1. 官方Demo解
小米推送常见问题
逆光/步履不停
08-01 4809
小米推送
iOS_Pass iOS10适配：权限访问、MiPush小米推送（更新中）
王学森的专栏
09-18 4034
iOS10官方文档原版翻译Pass_1iOS10 相册，相机内的提示文字变成了英文，比如，取消（cancel），完成（complete）等，解决方法在项目的info.plist里面添加Localized resources can be mixed 值为 YESPass_2iOS10 权限设置，相机、相册、地理位置、蓝牙等获取权限崩溃，解决方法在项目的info.plist里边添加相关的权限ke
推送系统iOS客户端SDK.zip
01-20
操作系统：LInux、IOS、树莓派、安卓开发、微机操作系统、网络操作系统、分布式操作系统等。此外，还有嵌入式操作系统、智能操作系统等。 网络与通信：数据传输、信号处理、网络协议、网络与通信硬件、网络安全网络...
小米推送服务端SDK-C#/.Net版
03-01
小米推送服务端SDK官方只提供了PHP与JAVA版本，C#、.Net小米官方是没有的，这个是通过JAVA版本转换成C#、.Net的版本，可以直接集成至现在C#、.Net的服务端项目，满足移动项目消息推送需求
小米推送Java代码
08-26
2. 高效：小米推送Java代码使用小米推送SDK，提供了高效的消息推送服务。 3. 灵活：小米推送Java代码可以根据环境来选择安卓或iOS推送，提供了灵活的消息推送解决方案。 六、小米推送Java代码的应用场景 小米推送...
iOS推送SDK集成详细对比
08-28
iOS推送SDK集成详细对比 本文将对iOS推送SDK进行详细的对比和分析，对SDK的集成、大小、价格等方面进行了深入的研究和比较。通过对比几个大平台的SDK，希望对读者有所帮助。 SDK集成 在集成方面，MobPush具有很大...
iOS中关于信鸽推送的使用demo详解
09-01
在iOS开发中，推送服务是应用与用户保持互动的重要手段，而信鸽推送服务就是一款常用的第三方推送解决方案。本文将详细解析如何在iOS项目中集成并使用信鸽推送的demo。 首先，集成信鸽推送服务涉及到的主要步骤如下...
MiPush_SDK_Client_3_5_2.jar
09-04
小米推送Android的SDK，3.5.2版本的，需要的可以下载。
MiPush_SDK_Server_2_2_21.jar
03-29
小米推送jar包
小米推送sdk java,java服务端集成小米推送
weixin_35342111的博客
03-10 748
MiPush_SDK_Server_2_2_17#单元测试测试广播发送所有clientPushMsg p = PushMsg.Builder.create().ios().passThrough()// .title("xx").content("xxx").extra("json", " {\"code\":0,\"count\":88888888888}").bu...
didRegisterForRemoteNotificationsWithDeviceToken不调用
今天明天
12-08 1万+
一般didRegisterForRemoteNotificationsWithDeviceToken 不调用的原因就几个：  1，证书问题；   （检查证书的是否有效）； 2，设置中没有打开通知开关；  （在配置常看，是否允许通知） 3，程序问题。 （a.看这个方法，有没有被重写，    b. 通知的需要的配置，是否进行配置）
TP5.1接入小米推送SDK并推送消息到手机
Sol的博客
02-08 867
首先进入小米开放平台下载PHP版本的SDK（点我进入下载页），下载后将压缩包内的php→sdk中的所有文件复制到TP5.1项目中extend中的子目录mipush中(mipush是我自己新建的空文件夹，名字随便起) SDK成功放入项目后我们要在需要使用的地方引入以下autoload.php即可，xmpush中的类都已经配置好了命名空间无需处理。这里推荐使用TP5.1提供的Env获取extend路...
Unity 回调didRegisterForRemoteNotificationsWithDeviceToken不执行的问题
q3386776的博客
02-14 383
获取通知回调不执行
iOS Method Swizzling和分类的妙用AppDelegate轻量化处理
weixin_30498921的博客
11-18 154
http://www.cocoachina.com/ios/20151117/14167.html 简介 在iOS工程中，AppDelegate往往会有上千行，甚至几千行，这样就会给维护AppDelegate带来诸多麻烦。比方说，老板想在出现HomeViewController之前弹出广告并停顿几秒，这样你就要加入插入广告的逻辑；又比方说，老板想在开始做个请求，判断某个开关是否打开。这样...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值