接入Unity应用

通过 .unitypackage 安装（推荐）

1. 下载 SDK 包

   从发布页面下载最新的 [alibabacloud-rum-unity-sdk.unitypackage](https://rum-sdk.oss-cn-hangzhou.aliyuncs.com/unity3d/alibabacloud-rum-unity-sdk.unitypackage) 文件。

2. 导入 Unity 项目

   • 打开您的 Unity 项目。

   • 在菜单栏选择 Assets -> Import Package -> Custom Package...。

   • 选择下载的 .unitypackage 文件。

   • 在弹出的导入对话框中，点击 Import 确认导入。

3. 导入后的目录结构

   Assets/
   ├── Runtime/           # SDK 运行时核心代码
   │   ├── Android/       # Android 平台适配
   │   ├── iOS/           # iOS 平台适配
   │   ├── Rum/           # RUM 核心实现
   │   ├── Worker/        # 后台工作线程
   │   └── ...
   └── Editor/            # SDK Editor 配置工具

1. 打开配置窗口

在 Unity 菜单栏选择 Tools -> Alibabacloud，打开 SDK 配置窗口。

2. 核心配置（Core Tab）

在 Core 页签中配置以下必填项：

3. 日志配置（Logging Tab）

4. 网络配置（Network Tab）

TraceContextStandard 枚举

定义于 Runtime/Network/TraceContextStandard.cs：

TraceContextConfig 类

配置 URL 模式与追踪标准的映射。

[Serializable]
public class TraceContextConfig
{
    public string UrlPattern { get; set; }  // URL 匹配模式
    public TraceContextStandard Standard { get; set; }  // 追踪标准
}

配置方式

在 Unity Editor 的 Network Tab 中配置：

1. 勾选 Enable Trace Context。

2. 添加 Trace Context Configs 条目。

3. 设置 Url Pattern（如 api.example.com）。

4. 选择 Standard（W3C 或 SkyWalking）。

Android 平台

<androidPackage spec="com.aliyun.rum:alibabacloud-android-rum-sdk:*.*.*">
  <repositories>
    <repository>https://repo1.maven.org/maven2</repository>
  </repositories>
</androidPackage>

iOS 平台

sudo gem install cocoapods

pod 'AlibabaCloudRUM', '*.*.*'

cd Your-Builds/iOS-Paths（或 Podfile 文件所在目录）
pod install
open Your-Unity-App.xcworkspace

Android

[AlibabaCloudRum] rum init success

iOS

[AlibabaCloudRUM] [INFO   ] [RUM] <start> AlibabaCloud RUM init success

Android 构建失败，提示找不到 RUM SDK 类

A: 确保 EDM4U 已正确解析依赖。检查 Assets/Plugins/Android 目录下是否生成了相关 Gradle 配置文件。

iOS 构建后崩溃

A: 确保使用 .xcworkspace 打开 Xcode 工程，并检查 AlibabaCloudRUMSDK.xcframework 是否正确链接。