react-native-oppo-push 使用 OPPO PUSH 客户端SDK接口文档（2.1.0版本），适配最新 Android 10（Android Q）的 OPPO 手机厂商推送，系统级触达，无拦截，亿级推送能力。

安装

在终端运行以下命令：

yarn add react-native-oppo-push

React Native 0.59 以及以下版本，需要手动 Link。

react-native link react-native-oppo-push

在 AndroidManifest.xml 文件中添加以下配置：

<application
    ...
    android:allowBackup="true"
    ...>
    <meta-data android:name="oppo_app_id" android:value="在 OPPO 推送平台的 AppId" />
    <meta-data android:name="oppo_app_key" android:value="在 OPPO 推送平台的 AppKey" />
    <meta-data android:name="oppo_app_secret" android:value="在 OPPO 推送平台的 AppSecret" />
    <meta-data android:name="oppo_channel_id" android:value="在 OPPO 推送平台配置的通道ID" />
    <meta-data android:name="oppo_channel_name" android:value="在 OPPO 推送平台配置的通道名称" />
    <meta-data android:name="oppo_channel_description" android:value="在 OPPO 推送平台配置的通道描述" />
    ...
</application>

Android 8.0（API ≥ 26），需要配置通道，参考 OPPO 文档。

Api

引入：

import {
    OppoPush,
    OPPOPushEmitter,
    OT_REGISTER,
    OT_UN_REGISTER,
    OT_GET_PUSH_STATUS,
    OT_GET_NOTIFICATION_STATUS,
    OT_SET_PUSH_TIME,
    OT_ERROR
} from "react-native-oppo-push";

OppoPush 模块的方法如下：

init 初始化 OPPO PUSH 服务，创建默认通道。
getRegister 获取注册OPPO PUSH推送服务的注册ID
unRegister 注销注册OPPO PUSH推送服务
requestNotificationPermission 弹出通知栏权限弹窗（仅一次）
isSupportPush 判断手机平台是否支持 OPPO PUSH 服务
openNotificationSettings 打开通知栏设置界面
getPushStatus 获取 OPPO PUSH 推送服务状态
getNotificationStatus 获取通知栏状态
pausePush 暂停接收 OPPO PUSH 服务推送的消息
resumePush 恢复接收OPPO PUSH服务推送的消息，这时服务器会把暂停时期的推送消息重新推送过来
getPushVersionCode 获取OPPO PUSH推送服务MCS版本（例如"1701"）
getPushVersionName 获取 OPPO PUSH 推送服务MCS名称（例如"1.7.1"）
getSDKVersion 获取 OPPO PUSH 推送服务SDK版本（例如"2.1.0"）
setPushTime 设置允许推送时间

常量如下：

OT_REGISTER 注册
OT_UN_REGISTER 注销
OT_GET_PUSH_STATUS 推送状态
OT_GET_NOTIFICATION_STATUS 通知状态
OT_SET_PUSH_TIME 设置推送时间
OT_ERROR 错误

事件订阅 OPPOPushEmitter

export default class App extends Component {
    constructor(props) {
        super(props);
        this.onOPPOPushListener = this._onOPPOPushListener.bind(this);
    }
    
    componentDidMount() {
        OPPOPushEmitter.on("OPPO_Push_Response", this.onOPPOPushListener);
    }

    componentWillUnmount() {
        OPPOPushEmitter.removeListener('OPPO_Push_Response', this.onOPPOPushListener);
    }
    
    _onOPPOPushListener(data) {
        let text = "";
        if (data != null) {
            let {code, data, status, message, type} = data;
            switch(type) {
                case OT_REGISTER:
                    if (code == 0) {
                        text = "【注册成功】registerId：" + data;
                    } else {
                        text = "【注册失败】code=" + code;
                    }
                    break;
                case OT_UN_REGISTER:
                    if (code == 0) {
                        text = "【注销成功】code=" + code;
                    } else {
                        text = "【注销失败】code=" + code;
                    }
                    break;
                case OT_GET_PUSH_STATUS:
                    if (code == 0 && status == 0) {
                        text = `【Push状态正常】code=${code},status=${status}`;
                    } else {
                        text = `【Push状态错误】code=${code},status=${status}`;
                    }
                    break;
                case OT_GET_NOTIFICATION_STATUS:
                    if (code == 0 && status == 0) {
                        text = `【通知状态正常】code=${code},status=${status}`;
                    } else {
                        text = `【通知状态错误】code=${code},status=${status}`;
                    }
                    break;
                case OT_SET_PUSH_TIME:
                    text = `【SetPushTime】code=${code},result:${data}`;
                    break;
                case OT_ERROR:
                    text = message;
                    break;
            }
        }
        console.log(text);
    }
}

Demo

Demo 代码参考 example
安卓手机也可以直接下载并安装已编译的 apk

React Native 安卓 OPPO 厂商推送

安装

Api

Demo