Android多通道接入

一、引入适配层

由于宿主app不一定接入了灯塔,所以使用调用灯塔接口前,需要判断一下相关类是否存在,适配层会帮你完成这个工作。

1.Maven/Gradle工程

引入适配层

implementation 'com.tencent.beacon:beacon-adapter-android:1.0.2'

注意这里依赖了beacon-adapter-android。在您的SDK发布到maven上时,pom文件中也要声明这个依赖。如果不清楚如何在pom文件中声明依赖,或者觉得麻烦,也可以用下面非Maven/Gradle的方式,直接引入adapter源码

2.非Maven/Gradle工程

2.1 源码引入适配层

源码地址:https://git.code.oa.com/beacon-open-source/beacon_sdk_adapter_android/blob/master/beacon-adapter/src/main/java/com/tencent/beacon/BeaconAdapter.java

将BeaconAdapter.java放到项目中,修改类名或包名(防止与别人冲突)

2.2 依赖灯塔SDK

将灯塔SDK jar包放到工程lib目录下,以便通过编译

记得不要把灯塔SDK打到你的jar包中

二、注册通道

使用在灯塔官网注册的appKey来注册通道

String version = "0.1.1";
String channel = "10000000";
BeaconAdapter.registerTunnel(SDKTest.TEST_APP_KEY, version, channel);

注册时机任意,无需考虑宿主app是何时初始化灯塔SDK的。事件上报同理

三、上报事件

使用以下方法上报事件

BeaconAdapter.onUserActionToTunnel(appKey, ...)

onUserActionToTunnel用法与onUserAction一致。但onUserActionToTunnel需要指定appKey

onUserAction方法使用文档:文档

多通道(非app主通道)不包含应用统计功能,不会上报任何灯塔内置事件。

这意味着灯塔应用统计上的数据(新增、日活等)将不可用。

但可以使用自定义事件相关的功能以及灯塔分析平台的所有功能