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

设置自定义用户 ID

SDK 内部会持久化保存自定义用户 ID。建议您在用户 ID 发生变化时（如用户登录、注销登录、切换用户等时机）设置自定义用户 ID。首次初始化点播 SDK 时也需要设置。详细的操作步骤如下所示。

初始化自定义用户 ID

在 SDK 初始化自定义用户 ID，实现的代码示例如下所示。

- (void)initTTSDK {
    // 初始化 SDK
    NSString *appId = @"xxx"; // 您在视频点播控制台获取的应用 ID
    [TTSDKManager startWithConfiguration:configuration];
    
    // SDK 初始化后设置 uuid 
    [TTSDKManager setCurrentUserUniqueID:<#userid#>]；
}

更新自定义用户 ID

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

// 您的用户登录成功/切换用户
- (void)onUserLogin {
    [TTSDKManager setCurrentUserUniqueID:<#userid#>];
}

移除自定义用户 ID

您的用户注销登录，移除自定义 ID，实现的代码示例如下所示。

// 您的用户注销登录
- (void)onUserLogout {
    [TTSDKManager clearUserUniqueID];
}

查看单设备播放数据

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