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 则添加该库，否则不添加。
    libresolv.tbd
    UserNotifications.framework
  

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

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

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

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
      if ([[UIDevice currentDevice].systemVersion floatValue] >= 10.0) {
          #ifdef NSFoundationVersionNumber_iOS_9_x_Max
          JPUSHRegisterEntity * entity = [[JPUSHRegisterEntity alloc] init];
    	    entity.types = UNAuthorizationOptionAlert | UNAuthorizationOptionBadge | UNAuthorizationOptionSound;
          [JPUSHService registerForRemoteNotificationConfig:entity delegate:self];
          #endif
      }
  
      #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广告标识符。根据自身情况选择是否带有 IDFA 的启动方法，并注释另外一个启动方法。
       */
       NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
       [JPUSHService setupWithOption:launchOptions appKey:@"abcacdf406411fa656ee11c3" channel:@"" apsForProduction:NO SadvertisingIdentifier:advertisingId];
  
       return YES;
    }
  
    - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
        // Required.
        [JPUSHService registerDeviceToken:deviceToken];
    }
  
    - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
        // Required.
        [JPUSHService handleRemoteNotification:userInfo];
    }
  
    // iOS 10 Support
    - (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger))completionHandler {
        // Required
        NSDictionary * userInfo = notification.request.content.userInfo;
  		 if([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
      		 [JPUSHService handleRemoteNotification:userInfo];
   	   }
  
      [[NSNotificationCenter defaultCenter] postNotificationName:@"JPushPluginReceiveNotification" object:userInfo];
  
      // 需要执行这个方法，选择是否提醒用户，有 Badge、Sound、Alert 三种类型可以选择设置
   	  completionHandler(UNNotificationPresentationOptionAlert | UNNotificationPresentationOptionBadge | UNNotificationPresentationOptionSound);     
    }
  
    // iOS 10 Support
    - (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler {
        // Required
        NSDictionary * userInfo = response.notification.request.content.userInfo;
        if([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
            [JPUSHService handleRemoteNotification:userInfo];
        }
  	    completionHandler();  // 系统要求执行这个方法
    }

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 官网文档