FLogConfig

SDK 日志文件的配置。

C++

USTRUCT(BlueprintType)
struct FLogConfig {
GENERATED_BODY()
public:
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LogConfig")
FString filePath = "";
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LogConfig")
int64 fileSizeInKB = 2048;
UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LogConfig")
ELOG_LEVEL level = ELOG_LEVEL::LOG_LEVEL_INFO;
FLogConfig() {}
FLogConfig(const agora::commons::LogConfig& AgoraData) {
filePath = UTF8_TO_TCHAR(AgoraData.filePath);
fileSizeInKB = AgoraData.fileSizeInKB;
level = (ELOG_LEVEL)AgoraData.level;
}
agora::commons::LogConfig CreateAgoraData() const {
agora::commons::LogConfig AgoraData;
SET_UABT_FSTRING_TO_CONST_CHAR___MEMALLOC(AgoraData.filePath, filePath)
AgoraData.fileSizeInKB = UABT::ToUInt32(fileSizeInKB);
AgoraData.level = (agora::commons::LOG_LEVEL)level;
return AgoraData;
}
void FreeAgoraData(agora::commons::LogConfig& AgoraData) const {
SET_UABT_FSTRING_TO_CONST_CHAR___MEMFREE(AgoraData.filePath)
}
};

filePath

日志文件的完整路径。声网建议你使用默认的日志路径。如果你需要修改默认的日志路径，请确保你指定的路径存在且可写。

默认路径为：

• Android：/storage/emulated/0/Android/data/<packagename>/files/agorasdk.log。
• iOS：App Sandbox/Library/caches/agorasdk.log。
• macOS：
  • 开启沙盒: App Sandbox/Library/Logs/agorasdk.log，例如 /Users/<username>/Library/Containers/<AppBundleIdentifier>/Data/Library/Logs/agorasdk.log。
  • 关闭沙盒: ～/Library/Logs/agorasdk.log
• Windows：C:\Users\<user_name>\AppData\Local\Agora\<process_name>\agorasdk.log。

fileSizeInKB

单个 agorasdk.log 日志文件的大小，单位为 KB，取值范围为 [128,20480]，默认值为 2,048 KB。如果你将 fileSizeInKByte 设为小于 128 KB，SDK 会自动调整到 128 KB；如果你将 fileSizeInKByte 设为大于 20,480 KB，SDK 会自动调整到 20,480 KB。

注意

该方法仅用于设置 agorasdk.log 文件的大小，对 agoraapi.log 不生效。

level

SDK 的日志输出等级，详见 ELOG_LEVEL。

例如，如果你选择 WARN 级别，就可以看到在 FATAL、ERROR 和 WARN 级别上的所有日志信息。