功能接入

本文档将为您介绍 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) {
  }
}

日志上报

在 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" ]
}