FLogConfig

  • Unreal Blueprint

更新时间不可用

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 级别上的所有日志信息。

表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?