Push Service Overview

React Native only encapsulates the interface for setting push parameters. The push functionality relies on the push capabilities of the Android and iOS platforms.

Integrating Push Functionality

Please refer to the push documentation for Android and iOS for integration.

• Android Push
• iOS Push

Setting Up Third-Party Push for Android

Class: RCIMEngine

Method: create(appKey: string, options: RCIMIWEngineOptions)

RCIMIWEngineOptions Description

export interface RCIMIWPushOptions {
    /**
     * Xiaomi Push Id
     */
    idMI?: string;

    /**
     *  Xiaomi Push appKey
     */
    appKeyMI?: string;

    /**
     * Meizu Push Id
     */
    appIdMeizu?: string;

    /**
     * Meizu Push appKey
     */
    appKeyMeizu?: string;

    /**
     * Oppo Push appKey
     */
    appKeyOPPO?: string;

    /**
     * Oppo Push appSecret
     */
    appSecretOPPO?: string;

    /**
     * Whether to enable Huawei Push
     */
    enableHWPush?: boolean;

    /**
     * Whether to enable FCM Push
     */
    enableFCM?: boolean;

    /**
     * Whether to enable Vivo Push
     */
    enableVIVOPush?: boolean;
}

Code Example

let options: RCIMIWEngineOptions = {};
let pushOptions: RCIMIWPushOptions = {
    idMI: 'xxx',
    appKeyMI: 'xxx',
    appIdMeizu: 'xxx',
    appKeyMeizu: 'xxx',
    appKeyOPPO: 'xxx',
    appSecretOPPO: 'xxx',
    enableHWPush: true,
    enableFCM: true,
    enableVIVOPush: true,
};
options.pushOptions = pushOptions;
let engine = RCIMIWEngine.create(appKey, options);

Setting iOS deviceToken

You can configure this according to the iOS push documentation. Note that when setting the deviceToken, you must use one of the following two methods; otherwise, the deviceToken cannot be reported, and you will not receive push notifications.

tip

You must set the deviceToken before establishing the IM connection (i.e., before calling the connect method).

• Method One: Set the deviceToken in the native iOS layer.

  #import <RongIMWrapper/RongIMWrapper.h>
  
  - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [RCIMIWEngine setDeviceToken:deviceToken];
  }

• Method Two: Set the deviceToken through the interface provided by React Native. Please set it before initializing the engine.

  engine.setDeviceToken(deviceToken);