简介
wjx-react-native-aliyun-push 是一个基于 React Native 框架的 Aliyun 推送模块。使用此模块可以在 React Native 中轻松地集成 Aliyun 推送服务,实现消息推送功能。本文将为大家介绍如何使用此 npm 包实现 Aliyun 消息推送。
安装
1. 安装 npm 包
在 React Native 项目中,使用 npm 包管理工具,直接执行如下命令进行安装:
npm install wjx-react-native-aliyun-push --save
2. 链接 Native 代码
使用 npm 包之后,在 React Native 项目中还需要手动链接 Native 代码。具体操作如下:
iOS 平台
进入项目目录下,执行如下命令:
react-native link wjx-react-native-aliyun-push
注意,如果您的 React Native 版本低于 0.60,需要手动执行以下命令:
react-native link
手动生成配置文件,并按照官方文档描述集成代码。
Android 平台
本模块只需在 android/app/build.gradle
文件中添加以下依赖库引用:implementation 'com.aliyun.mns:x.x.x'
。x.x.x 是阿里云 MNS SDK 版本号,具体版本号请查看 npm 包说明文档。
使用
1. 配置
在 React Native 项目中使用该模块之前,需要首先配置模块:
-- -------------------- ---- ------- ------ - ---------- - ---- ------------------------------- ----- --------- - ----- -- -- - ----- -------------------------------------------- -------- ----- ----------------------- ---------- ----- ------------------------------ -------- ----- ---------------------------------- ------ -- ------------
其中,registerAccount
函数是为了开启阿里云推送账号服务。账号是根据设备来统计的,每次调用 registerAccount
都会将之前的账号覆盖,如果不需要使用账号服务,可以不调用此函数。
2. 监听事件
在配置完成之后,就可以监听事件了,例如在消息推送时,会触发 messageReceived
事件:
-- -------------------- ---- ------- ------ - ---------- - ---- ------------------------------- ------------------- - -------------- - ----------------------------------------- ------------------------ - ---------------------- - ------------------------------------------ --------- - ----------------- - ------- -- - ------------------- --------------- --
超级推送消息的 Payload:
-- -------------------- ---- ------- - ------- - -------- - ---------- -------- -------- -------- -------- ---- -- ---------- - ---------- ------ --------- -------- ------ --------- -------- --- -------- -- ---------- ------ --------- --------- - ------ -------- ------- -------- - -- ------------ - ---------- ----------------- - -
3. 推送
调用 pushMessage
接口可以推送消息:
-- -------------------- ---- ------- ------ - ---------- - ---- ------------------------------- ----- ---- - ----- -- -- - ----- ----------- - - ------ ----- -------- ------- ------- - ----- --------- ----- --------- -- -- ----- --- - ----- ------------------------ ----- ---------------------------- ------- --------- ------------ ------- ------------ ---------- --- ------------------- ----- -- -------
其中,data
字段是消息体,可以自定义结构;target
字段是推送目标,可以选择 DEVICE(设备) 或 ACCOUNT(账户);targetValue
字段是推送目标值,可以是设备 ID 或者账号;messageType
字段是消息类型,可以选择 MESSAGE 或者 NOTICE。
总结
本文介绍了 wjx-react-native-aliyun-push 模块的安装、配置、事件监听和推送操作,希望对大家了解如何在 React Native 中使用 Aliyun 推送服务有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005730381e8991b448e92c0