播放器 SDK 提供一套日志回调机制，允许您在应用中实时获取 SDK 内部的详细运行日志，以便于进行功能调试和问题排查。

实现流程 #

步骤 1：设置日志级别 #

在初始化 TTSDKManager 之前，通过 setLogFlag: 设置您希望获取的日志类型。在调试阶段，建议开启全部日志。

// 在调用 [TTSDKManager startWithConfiguration:...] 之前

// 开启所有类型的日志输出。
// 您也可以根据 TTVideoEngineLogFlag 的定义，组合使用不同的日志级别。
[TTVideoEngine setLogFlag:TTVideoEngineLogFlagAll];

步骤 2：实现日志代理协议 #

创建一个独立的类，并使其遵守 TTVideoEngineLogDelegate 协议，将日志处理逻辑封装在这个类中。

#import <TTSDKFramework/TTVideoEngine.h>

// 声明一个类并遵守 TTVideoEngineLogDelegate 协议
@interface ExampleVodLogger : NSObject <TTVideoEngineLogDelegate>

@end

@implementation ExampleVodLogger

/**
 * 日志回调方法
 * @param log 单条日志的内容字符串
 */
- (void)consoleLog:(NSString *)log {
    // 在这里处理 SDK 回调的日志内容
    // 例如：使用 NSLog 打印、写入本地文件或上报到您自己的日志系统
    NSLog(@"[TTVideoEngine] %@", log);
    
    // 注意：不要同步执行过于复杂的任务，以免影响整体性能。
}

@end

步骤 3：设置日志代理实例 #

在初始化 TTSDKManager 之后、开始播放之前，创建代理类的实例并将其设置给 TTVideoEngine。

// 在初始化 TTSDKManager 之后
- (void)setupPlayerEnvironment {
    // ...
    // [TTSDKManager startWithConfiguration:configuration];
    // ...

    // 创建实例并设置代理
    _logger = [[ExampleVodLogger alloc] init];
    [TTVideoEngine setLogDelegate:_logger];
}