Kimi2016 / jpush-unity3d-plugin

JPush's officially supported Unity3d plugin (Android & iOS). 极光推送官方支持的 Unity3d 插件（Android & iOS）。

JPush Unity Plugin

这是极光官方支持的 JPush Unity 插件（Android & iOS）。

集成

运行插件目录下的 JPushUnityPlugin_vX.X.X.unitypackage。

Android

• 替换 AndroidManifest.xml 里的包名。
• 将 AndroidManifest.xml 中的 JPUSH_APPKEY 值替换成极光控制台应用详情中的 AppKey 值。
• 配置项目里的包名：在 Unity 中选择 File---Build Settings---Player Settings，将 Identification 选项下的 Bundle Idenifier 设置为应用的包名。
• 配置项目的图标。

iOS

• 在 Unity 游戏场景中，新建一个空的 Gameobject，将其名称修改为 JPushBinding，挂载 JPushBinding.cs。

• 生成 iOS 工程，并打开该工程。

• 添加必要的框架。

    CoreFoundation.framework
    CFNetwork.framework
    SystemConfiguration.framework
    CoreTelephony.framework
    CoreGraphics.framework
    Foundation.framework
    UIKit.framework
    Security.framework
    libz.tbd            // Xcode7 之前为 libz.dylib 之后为 libz.tbd。
    AdSupport.framework // 如需使用广告标识符 IDFA 则添加该库，否则不添加。
  

• 在 UnityAppController.mm 中添加头文件 JPUSHService.h。

    #import "JPUSHService.h"
    // 如需使用广告标识符 IDFA 则添加该头文件，否则不添加。
    #import <AdSupport/AdSupport.h>
  

• 在 UnityAppController.mm 的下列方法中添加以下代码：

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
    {
        // Required.
    	#if __IPHONE_OS_VERSION_MAX_ALLOWED > __IPHONE_7_1
    	    if ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) {
    	        // 可以添加自定义 categories。
    	        [JPUSHService registerForRemoteNotificationTypes:(UIUserNotificationTypeBadge |
    	                                                       UIUserNotificationTypeSound |
    	                                                       UIUserNotificationTypeAlert)
    	                                           categories:nil];
    	    } else {
    	        // categories 必须为 nil。
    	        [JPUSHService registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge |
    	                                                       UIRemoteNotificationTypeSound |
    	                                                       UIRemoteNotificationTypeAlert)
    	                                           categories:nil];
    	    }
    	#else
    	    // categories 必须为 nil。
    	    [JPUSHService registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge |
    	                                                   UIRemoteNotificationTypeSound |
    	                                                   UIRemoteNotificationTypeAlert)
    	                                       categories:nil];
    	#endif
  
    	/*
           不使用 IDFA 启动 SDK。
           参数说明：
               appKey: 极光官网控制台应用标识。
               channel: 频道，暂无可填任意。
               apsForProduction: YES: 发布环境；NO: 开发环境。
         */
        [JPUSHService setupWithOption:launchOptions appKey:@"abcacdf406411fa656ee11c3" channel:@"" apsForProduction:NO];
  
        /*
            使用 IDFA 启动 SDK（不能与上述方法同时使用）。
            参数说明：
                appKey: 极光官网控制台应用标识。
                channel: 频道，暂无可填任意。
                apsForProduction: YES: 发布环境；NO: 开发环境。
                advertisingIdentifier: IDFA广告标识符。
         */
        NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
        [JPUSHService setupWithOption:launchOptions appKey:@"abcacdf406411fa656ee11c3" channel:@"" apsForProduction:NO advertisingIdentifier:advertisingId];
  
    	return YES;
    }
  

在 [JPUSHService setupWithOption:appKey:channel:apsForProduction:advertisingIdentifier:] 方法中：

• appkey: 填写自己应用的 AppKey。

• apsForProduction: 根据所用 Apple 证书的不同填写。

  • YES: 发布环境。
  • NO: 开发环境。

• advertisingIdentifier: 根据自身情况选择是否带有 IDFA 的启动方法，并注释另外一个启动方法。

    - (void)application:(UIApplication *)application 	didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    	// Required.
    	[JPUSHService registerDeviceToken:deviceToken];
    }
  
    - (void)application:(UIApplication *)application 	didReceiveRemoteNotification:(NSDictionary *)userInfo {
    	// Required.
    	[JPUSHService handleRemoteNotification:userInfo];
    }
  

API 说明

Android

在 Plugins\Android\src 目录下是一些 Java 文件，可以将其引入到 Android 工程中对其进行扩展，重新生成 Jar 包替换掉工程中 Assets\Plugins\Android 目录下的 JPush_Bridge.jar 文件。

Android SDK API。

iOS

iOS API 在文件 /Plugins/JPushBinding.cs 中，代码 #if UNITY_IPHONE 后面的即为可调用的 iOS API。

iOS SDK API。

亦可参照以下文档中与 JPushBinding.cs 中相同方法名的方法说明：

JPush Phonegap Plugin Common API doc

JPush Phonegap Plugin iOS API doc

更多

• JPush 官网文档。
• 有问题可访问极光社区搜索和提问。