快速开始

最近更新时间：2023.05.25 10:08:07

首次发布时间：2023.02.10 17:13:02

本文为您介绍 Android 加载 SDK 的初始化和基本使用。

前提条件

已开通 veImageX服务，未注册用户可注册账号免费试用。
已完成创建应用。
已完成加载 SDK 的集成准备。

初始化

数据统计功能需要完成 Applog 的初始化以及采样率设置。请在 Application 的onCreate方法调用 initApplog() 和initCloudConfig()，代码示例如下所示：

注意

SDK 支持在控制台输出日志，用于观察用户行为日志上报情况。但请您在上线前请关闭该能力，将setLogEnable设为false并删除setLogger配置。
初始化 Applog 时会采集用户信息，请确保您采集用户信息之前已经获得用户授权。合规建议：用户授权后再进行 Applog 的初始化，取得用户授权前所有信息不会采集，预置事件也不会被采集。

@Override
public void onCreate() {
    super.onCreate();
    initCloudConfig(); //设置采样率
    initApplog(); // 初始化 Applog
}

private void initApplog() {
    /* 初始化开始  */
    final com.bytedance.applog.InitConfig config = new com.bytedance.applog.InitConfig("your_appid", "your_channel"); // appid和渠道，appid如不清楚请提交工单咨询，注意第二个参数 channel 不能为空
    config.setUriConfig (UriConstants.DEFAULT);//国内上报地址，国外则有SINGAPORE,AMERICA,SINGAPORE_ALI,REGION_DEFAULT(=SINGAPORE)

    config.setLogEnable(true)// 是否在控制台输出日志，可用于观察用户行为日志上报情况，上线请关闭该能力
    config.setLogger(new ILogger() {
        @Override
        public void log(String s, Throwable throwable) {
            Log.d("AppLog------->: ",""+s);//指定为 debug 包才会打印日志
        }
    });

    config.setH5CollectEnable (false);//关闭内嵌H5页面的无埋点事件

    AppLog.setEncryptAndCompress(true);  // 加密开关。false：关闭；true：开启

    config.setAutoStart(true);
    AppLog.init(this, config);
    /* 初始化结束 */
}

设置采样率配置，具体代码如下所示：

private void initCloudConfig() {
CloudInitConfig initConfig = new CloudInitConfig(
    this,
    aid,      //业务的 appId，应用管理获取
    "xxx", //应用名称，业务方 app 名，根据实际业务填写
    "xxx",  //渠道，根据实际业务填写
    "0.0.1",  //versionName，App 版本号，根据实际业务填写
    "1",      //versionCode，App 版本 code，根据实际业务填写
    "48144589260",//deviceId，设备 ID，根据实际业务填写
    CloudInitConfig.CHINA // CHINA：国内；SINGAPORE：新加坡；US_EAST：海外
);

CloudControl.init(initConfig);
}

SDK 在集成之前需要获取下表内参数。

参数	说明
appID	SDK 用于打点监控上报的最小单元，简写为 aid。您可通过控制台我的应用获取。通过此将数据进行隔离上报，同时通过 AppID 可以拉取对应的云控配置，比如客户端采样率、网络优化参数等。
deviceId	设备 ID，根据实际业务填写，设备的唯一编号，用于统计区分使用。
appName	应用名称，根据实际业务填写，用于统计使用。
versionName	App 版本号，根据实际业务填写，主要用于数据统计与配置拉取。
versionCode	App 版本 code，根据实际业务填写，主要用于数据统计与配置拉取。
channel	渠道标识，根据实际业务填写。用于区分统计不同渠道来源的图片服务质量数据，如传入 huawei、oppo 等不同渠道标识。

请在app module下继承AppGlideModule，并通过GlideBuilder添加监控工厂类StatisticsTraceListenerFactory，代码示例如下所示：

@GlideModule(glideName = "ImgurGlide")
public class ImgurGlideModule extends AppGlideModule {
  // Intentionally Empty.
  @Override
  public void applyOptions(@NonNull Context context, @NonNull GlideBuilder builder) {
    super.applyOptions(context, builder);
    builder.setTraceListenerFactory(new StatisticsTraceListenerFactory());
  }
}

使用

BDGlide 基于开源 Glide 进行开发，其使用方式和官方 Glide 相同。且对 API 暂无修改，具体请参考 Glide 官方代码。

前提条件

初始化

使用

veImageX

快速开始

前提条件

初始化

使用