原生Android事件模块

本节将介绍将 now.gg 事件模块（Events module）与您的开发环境集成的步骤。

首先，下载包含now.gg事件模块的now.gg SDK包，并将其添加到您的开发环境中。

添加SDK库

首先，下载包含事件模块库的now.gg SDK包，并按照以下步骤将其添加到您的开发环境中：

注意：now.gg SDK包包含事件模块和示例代码。

1. 解压now.gg事件模块的压缩包，并在包中找到.aar文件：

 events.aar

2. 添加以下依赖项到您游戏的 build.gradle 文件：

dependencies {
         implementation fileTree(dir: 'libs', include: ['*.aar'])
 }

使用事件模块

模块成功导入后，您现在就可以使用now.gg事件模块了。

我们提供了一些示例命令/事件作为您实现的参考。

您可以使用 NowGGEventsSdkManager 类来触发事件，如下所示：

1. Open Url

您可以调用 NowGGEventsSdkManager 类的 openUrl 方法，将指定的 URL 在新浏览器窗口中打开，如下所示：

string url = "https://example.com";

 NowGGEventsSdkManager.getInstance().openUrl(url, activityContext);

注意: 请确保在您的应用可启动的活动中调用 openUrl 方法。

参考 : 有关 openUrl() 的更多信息，请点击此处。

2. 发送事件和数据到HTML页面

您可以使用必需的参数调用 NowGGEventsSdkManager 类的 sendEventToBrowser 方法，将事件和数据发送到HTML页面并在那里处理。

a. 发送事件到HTML页面

string eventName = "test-event";
 string eventData = "test-data";

 NowGGEventsSdkManager.getInstance().sendEventToBrowser(eventName, eventData, activityContext);

参考资料 : sendEventToBrowser() 关联的附加信息可以在此处找到。

b. 在HTML页面处理事件

数据发送到您的HTML后，您可以在那里处理它，如下所示：

const eventCallbackFunction = (event) => {
 console.log(event.eventName); // event1
 console.log(event.eventData); // eventData1
  
 // 此处执行基于事件的处理
 };

3. 向Android应用发送事件和数据

可以使用now.gg 嵌入模块的sendEventToApp函数和所需参数，将事件和数据发送到Android应用并进行处理。

a. 向Android应用发送事件

sendEventToApp通过now.gg嵌入模块的NowIfp接口发送自定义事件和相关数据到应用，示例如下：

const sendEventToApp = () => {
     const eventName = 'CustomEvent';
     const eventData = JSON.stringify({
         Sample: 'case'
     });
     NowIfp.sendEventToApp(eventName, eventData);
 };

b. 在Android应用中处理事件

数据发送到Android应用后，可通过以下步骤进行处理：

1. 声明事件回调并注册监听器

定义一个回调函数以处理接收到的事件。

NowGGEventCallback eventCallback = (String eventName, String eventData) -> {
     // Perform tasks based on the eventName and eventData
     };

 NowGGEventsSdkManager.getInstance().registerEventListener(this, eventCallback);

2. 释放事件监听器

在销毁父活动时，需要释放事件监听器以避免内存泄漏和不必要的回调。通常在应用的onDestroy()方法中完成。

NowGGEventsSdkManager.getInstance().unregisterEventListener(this);

4. 在您应用内获取应用启动数据

我们提供了两种方法，用于获取您从HTML页面发送到Android应用程序的应用程序启动数据。

a. 使用bundle来获取所有应用程序启动数据参数

您可以调用 NowGGEventsSdkManager 类的getAppLaunchDataBundle 方法，如下所示：

//获取所有应用启动数据参数的bundle
 
 Bundle bundle = NowGGEventsSdkManager.getInstance().getAppLaunchDataBundle(activityContext);

参考资料 – getAppLaunchDataBundle() 关联的附加信息可以在此处找到。

b. 使用属性名来获取特定的应用程序启动数据参数

您可以使用属性名调用 NowGGEventsSdkManager 类的 getAppLaunchDataProperty() 方法，以获取特定的应用启动数据参数，如下所示：

//通过属性名获取应用启动数据的属性 

 String property = NowGGEventsSdkManager.getInstance().getAppLaunchDataProperty("event_name", activityContext);

注意：若找不到属性则返回空字符串。

参考资料: getAppLaunchDataProperty() 关联的附加信息可以在此处找到。

开始集成

参考资料