视频点播提供单点追查功能，即对用户的单次播放行为进行全链路追踪和问题定位。您可通过点播 SDK 和视频点播质量平台实现该能力。默认情况下，点播 SDK 会自动生成唯一的设备 ID，您可在质量平台追查该设备 ID 的播放记录。但是如果您自己已有一套独立的用户 ID 体系，希望通过用户 ID 来追查单个用户的单次播放行为，则可根据本文自定义用户 ID。

设置自定义用户 ID

可在 SDK 初始化时自定义用户 ID。示例代码如下：

private void initVodSDK(Context context, String userUniqueId) {
    // 1. 根据 “快速开始” 文档初始化点播 SDK
    Env.init(new Config.Builder()
        // ... 省略
        .build());
    // 2. 获取 AppLog 实例设置 userUniqueId
    IAppLogInstance applog = AppLogWrapper.getAppLogInstance();
    if (applog != null && !TextUtils.isEmpty(userUniqueId)) {
        applog.setUserUniqueID(userUniqueId); 
    }
}

移除自定义用户 ID

在终端用户注销登录时移除自定义的设备 ID。示例代码如下：

// 终端用户注销登录时调用
private void onUserLogout() {
    IAppLogInstance applog = AppLogWrapper.getAppLogInstance();
    if (applog != null) {
        applog.setUserUniqueID(null);
    }
}

更新自定义用户 ID

终端用户登录成功或者切换登录，更新用户 ID，实现的代码示例如下所示。

// 登录成功/切换后调用
private void onUserLogin(String userUniqueId) {
    IAppLogInstance applog = AppLogWrapper.getAppLogInstance();
    if (applog != null) {
        applog.setUserUniqueID(userUniqueId);
    }
}

查看单设备播放数据

设置自定义用户 ID 后，您可在视频点播控制台单点追查页面查看该 ID 的播放记录。详细操作说明请见单点追查。