简介
react-native-theorem-reach 是一个用于 React Native 的定制原生模块，可以让你在应用中使用 TheoremReach 提供的奖励系统。使用该模块可以在应用中添加广告或问卷调查，让用户完成后即可获取奖励，提高用户参与度。
环境要求
- React Native 版本 >= 0.60
- iOS 或 Android 应用
安装
使用 npm 安装 react-native-theorem-reach ：
npm install --save react-native-theorem-reach
安装之后，我们需要使用原生包管理工具来进行配置：
iOS
- 首先，安装 Cocoapods ，并在项目的
ios目录下创建Podfile文件，内容如下：
-- -------------------- ---- ------- -------- ----- ----- ------ --------- -- - --------- ------------ - --- - ------------ ---------- --- --------------- --- ---- ---
运行
pod install安装 TheoremReach。打开 xcodeproj ，添加
libRNRTheoremReach.a到 Linked Frameworks and Libraries 中。在
AppDelegate.m中添加依赖：
#import <TheoremReach/TheoremReach.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[TheoremReach initWithApiKey:@"YOUR_API_KEY_HERE" userId:@"12345678"];
// ...
}Android
- 在
build.gradle文件中添加以下依赖：
dependencies {
// ...
implementation 'com.theoremreach:theoremreach:4.0.2'
implementation project(':react-native-theorem-reach')
}- 在
strings.xml中添加以下定义：
<resources> <string name="theoremreach_api_key">YOUR_API_KEY_HERE</string> </resources>
- 在
MainActivity.java中添加依赖：
-- -------------------- ---- -------
------ ------------------------------------
------ ----- ------------ ------- ------------- -
---------
--------- ------ --------------------- -
------ --------
-
---------
--------- ---- --------------- ------------------- -
-----------------------------------
----------------------------------------------------------------------- -------------------------
-
-使用方法
导入模块
import TheoremReach from 'react-native-theorem-reach';
显示奖励
当用户完成了由 TheoremReach 提供的调查或任务时，可以显示奖励。
TheoremReach.onRewardCenterOpened();
事件监听
可以在应用中监听 TheoremReach 触发的事件，例如：奖励可用、奖励已过期等。
-- -------------------- ---- -------
------------------- -
--------------------------------------------- ------------------------
------------------------------------------------ ---------------------------
------------------------------------------------ ---------------------------
------------------------------------------------------ ---------------------------------
--------------------------------------------------- ------------------------------
-
---------------------- -
------------------------------------------------ ------------------------
--------------------------------------------------- ---------------------------
--------------------------------------------------- ---------------------------
--------------------------------------------------------- ---------------------------------
------------------------------------------------------ ------------------------------
-
----------------- - -------------- -- -
------------------------------- -- --------------
-
-------------------- - -- -- -
------------------------------------
-
-------------------- - -- -- -
------------------------------------
-
-------------------------- - -- -- -
------------------------------------------
-
----------------------- - -- -- -
---------------------------------------
-参数说明
init(apiKey: string, userId: string)
初始化 TheoremReach 模块，传入 ApiKey 和 UserId 。这个方法在应用启动时应该调用一次。
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| apiKey | string | Yes | TheoremReach 提供的 ApiKey |
| userId | string | Yes | 应用中唯一标识用户的 ID |
onRewardCenterOpened()
用户进入奖励中心时调用。
onRewardAvailable(rewardParams: object)
当用户获得了奖励时触发，rewardParams 是一个包含了奖励信息的对象。
| 参数名 | 类型 | 描述 |
|---|---|---|
| rewardName | string | 奖励的名称 |
| rewardAmount | number | 奖励的数量 |
| rewardItemId | string | 成功后可获得奖励的 ID |
addListener(eventName: string, callback: function)
添加对特定事件的监听。
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| eventName | string | Yes | 要监听的事件名称 |
| callback | function | Yes | 事件触发时执行的回调函数 |
removeListener(eventName: string, callback: function)
取消对特定事件的监听。
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| eventName | string | Yes | 要取消监听的事件名称 |
| callback | function | Yes | 要取消的回调函数 |
示例代码
-- -------------------- ---- -------
------ ------ - --------- - ---- --------
------ - ----- ----- ------ - ---- ---------------
------ ------------ ---- -----------------------------
----- --- ------- --------- -
------------------- -
--------------------------------------------- ------------------------
-
---------------------- -
------------------------------------------------ ------------------------
-
----------------- - -------------- -- -
------------------------------- -- --------------
-- -----
---------- ------ ----------- - ------------------------- ---
-- ------
----------- ---------------------------- -------
-
---------------------- - -- -- -
------------------------------------
-
-------- -
------ -
----- -------- ----- -- --------------- --------- ----------- -------- ---
--------------------------------------
------- -------------- ------------------------------------- --
-------
--
-
-
------ ------- ----总结
react-native-theorem-reach 让我们可以方便地在 React Native 应用中接入 TheoremReach 奖励系统，提高用户参与度。妥善地配置和使用 TheoremReach 可以为应用带来更好的用户体验和更多的用户留存，值得我们学习和推广。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6006735b890c4f7277583f38