You need to enable JavaScript to run this app.
导航
功能接入
最近更新时间:2024.03.05 13:39:05首次发布时间:2023.02.10 17:13:07

本文档将为您介绍 Android 加载 SDK 的相关能力接入说明。

初始化 TTNet(可选)

TTNet 是经过高度优化的自研客户端网络库,性能更优。如果您需要接入网络库 TTNet,请首先完成网络库 TTNet 初始化。具体代码如下所示:

@Override
public void onCreate() {
    super.onCreate();
    
    initTTNet();//初始化TTNet
}

private void initTTNet(String appId) {
  TTNetInit.setTTNetDepend(new TTNetDepend(this, appId));

  TTNetInit.tryInitTTNet(this,
          this,
          null,
          null,
          null,
          true);
  String deviceId = "xxx"; //设备 ID,根据实际业务填写,设备的唯一编号,用于统计区分使用。
  String versionCode = "1"; //App 版本 code,根据实际业务填写,主要用于数据统计与配置拉取。
  String versionName = "0.0.1"; //App 版本号,根据实际业务填写,主要用于数据统计与配置拉取。
  String channel = "xxx"; //渠道标识,根据实际业务填写。用于区分统计不同渠道来源的图片服务质量数据,如传入 huawei、oppo 等不同渠道标识。
  String appName = "xxx"; //应用名称,根据实际业务填写,用于统计使用。
  try {
    TTNetCronetDependAdapter adapter = new TTNetCronetDependAdapter(
            appId, deviceId, versionCode, versionName, channel, appName);
    CronetDependManager.inst().setAdapter(adapter);
    CronetAppProviderManager.inst().setAdapter(adapter);
    TTNetInit.preInitCronetKernel();

  } catch (Throwable throwable) {
  }
}

日志上报

说明

该能力依赖 Applog 模块,若未完成初始化和启动 Applog,则无法使用该功能。

在 1.4.0-tob 及之后版本的 SDK 已经新增支持性能日志上报和大图监控日志上报。您需要首先在控制台内SDK 配置下发配置采样率配置,具体请参考客户端配置下发
完成控制台配置后,客户端将拉取您配置的采样率。代码示例如下所示:

CloudInitConfig initConfig = new CloudInitConfig(
    this,
    aid,
    "xxx",
    "xxx",
    "0.0.1",
    "1",
    "48144589260",
    CloudInitConfig.CHINA
);

CloudControl.init(initConfig);

性能日志数据的上报是在 SDK 内完成,但开启大图监控需要添加以下代码,您可以自定义大图命中条件。代码示例如下所示:

StatisticsTraceListener.setExceedTheLimitBitmapMonitorEnabled(true);//开启大图监控日志上报

StatisticsTraceListener.setExceedTheLimitBitmapMonitorLimit(limitFileSize, limitBitmapContrast, limitRamSize);//limitFileSize:文件大小阈值;limitBitmapContrast:bitmap跟view尺寸倍数阈值;limitRamSize:内存大小阈值

开启后请进入 veImageX 控制台 > 服务质量监控 > 感知指标监控 > 大图监控 下查看大图监控日志上报数据。

设置隐私数据采集开关

设置 Android ID 采集开关

关闭 Android ID 会影响 did 卸载重装一致性,请谨慎关闭。设备的 Android ID 采集默认开启,如需关闭:

config.setAndroidIdEnabled(false);

如需移除 Android ID 采集代码,可以在全埋点 Plugin 中配置:

// 本功能仅支持1.4.0-tob及以上版本
teaExtension {
    // ... 其他配置
    trackBlackList = [ "ANDROIDID" ]
}

设置 MEID 采集开关

设备的 imei 地址采集默认开启。如需关闭:

config.setImeiEnable(false);

如需移除 IMEI 和 MEID 采集的相关代码,可以在全埋点 Plugin 中配置:

// 本功能仅支持1.4.0-tob及以上版本
teaExtension {
    // ... 其他配置
    trackBlackList = ["IMEI_MEID"]
}

设置 MAC 地址采集开关

设备的 mac 地址采集默认开启。如需关闭:

config.setMacEnable(false);

如需移除 MAC 地址采集的相关代码,可以在全埋点插件 Plugin 中配置:

// 本功能仅支持1.4.0-tob及以上版本
teaExtension {
    // ... 其他配置
    trackBlackList = ["MAC_ADDRESS"]
}

设置 OAID 采集开关

设备的 OAID 信息采集默认开启。如需关闭:

config.setOaidEnabled(false);

如需移除 OAID 采集的相关代码,可以在全埋点Plugin中配置:

// 本功能仅支持1.4.0-tob及以上版本
teaExtension {
    // ... 其他配置
    trackBlackList = [ "OAID" ]
}