Merge pull request #240 from flashcatcloud/docs/harmony-tracking-consent

docs(harmony): expand tracking-consent section to match the Android page

Author: Fiona2016

en/rum/sdk/harmony/advanced-config.mdx

@@ -40,20 +40,35 @@ const config = new ConfigurationBuilder('<CLIENT_TOKEN>', 'production')
 
 ## Tracking consent
 
-Pass `TrackingConsent` during initialization. You can also update it at runtime with `Flashcat.setTrackingConsent()`.
+To comply with privacy regulations such as GDPR and CCPA, the SDK requires a tracking consent state at initialization (the third argument of `Flashcat.initialize()`), and lets you change it at any time afterwards.
+
+### Consent states
+
+| State | Behavior | When to use |
+|-------|----------|-------------|
+| `TrackingConsent.GRANTED` | Collects data and sends it to Flashduty | The user has agreed to data collection |
+| `TrackingConsent.NOT_GRANTED` | Collects nothing | The user has declined data collection |
+| `TrackingConsent.PENDING` | Collects data but does not send it | Waiting for the user's decision |
+
+<Info>
+When initialized with `TrackingConsent.PENDING`, the SDK writes events to a separate local buffer and sends nothing until consent changes to `GRANTED` — at which point the buffered data is migrated and uploaded automatically. Changing to `NOT_GRANTED` clears the buffer instead.
+</Info>
+
+### Setting and changing consent
+
+At initialization:
 
 ```ts
 import { Flashcat, TrackingConsent } from '@flashcatcloud/core';
 
-Flashcat.setTrackingConsent(TrackingConsent.PENDING);
-Flashcat.setTrackingConsent(TrackingConsent.GRANTED);
+Flashcat.initialize(this.context, coreConfig, TrackingConsent.PENDING);
 ```
 
-| State | Behavior |
-|-------|----------|
-| `GRANTED` | Writes to the main upload directory and starts batch uploads |
-| `PENDING` | Writes events to a separate pending buffer; when consent changes to `GRANTED`, the SDK migrates and uploads them |
-| `NOT_GRANTED` | Drops new events, clears the pending buffer, and stops uploads |
+After initialization, via the `setTrackingConsent` API (for example once the user responds to your privacy dialog):
+
+```ts
+Flashcat.setTrackingConsent(TrackingConsent.GRANTED);
+```
 
 <Warning>
 Trace headers also honor tracking consent. The SDK injects correlatable `traceparent` and `tracestate` headers only when consent is `GRANTED`.

zh/rum/sdk/harmony/advanced-config.mdx

@@ -38,22 +38,37 @@ const config = new ConfigurationBuilder('<CLIENT_TOKEN>', 'production')
 `Flashcat.initialize()` 同一个实例名只会初始化一次。重复初始化会返回已存在实例，不会重新注册功能模块。
 </Note>
 
-## 隐私同意状态
+## 用户跟踪同意
 
-初始化时需要传入 `TrackingConsent`。你也可以在运行时通过 `Flashcat.setTrackingConsent()` 修改。
+为遵守 GDPR、CCPA 等隐私法规，SDK 要求在初始化时设置用户跟踪同意状态（`Flashcat.initialize()` 的第三个参数），并可在初始化后随时变更。
+
+### 同意状态说明
+
+| 状态 | 行为 | 使用场景 |
+|------|------|----------|
+| `TrackingConsent.GRANTED` | 开始收集数据并发送到 Flashduty | 用户已同意数据收集 |
+| `TrackingConsent.NOT_GRANTED` | 不收集任何数据 | 用户拒绝数据收集 |
+| `TrackingConsent.PENDING` | 收集数据但不发送 | 等待用户确认 |
+
+<Info>
+如果初始化时使用 `TrackingConsent.PENDING`，SDK 会将事件写入单独的本地缓冲区，但在同意状态更改为 `GRANTED` 之前不会发送；变更为 `GRANTED` 后缓冲数据自动迁移并上传，变更为 `NOT_GRANTED` 则清空缓冲。
+</Info>
+
+### 设置与更改同意状态
+
+初始化时设置：
 
 ```ts
 import { Flashcat, TrackingConsent } from '@flashcatcloud/core';
 
-Flashcat.setTrackingConsent(TrackingConsent.PENDING);
-Flashcat.setTrackingConsent(TrackingConsent.GRANTED);
+Flashcat.initialize(this.context, coreConfig, TrackingConsent.PENDING);
 ```
 
-| 状态 | 行为 |
-|------|------|
-| `GRANTED` | 写入主上传目录并启动批量上传 |
-| `PENDING` | 事件写入单独的 pending 缓冲区，不上传；变更为 `GRANTED` 后迁移并上传 |
-| `NOT_GRANTED` | 丢弃新事件，清空 pending 缓冲区并停止上传 |
+初始化后通过 `setTrackingConsent` API 更改（例如用户在隐私弹窗中做出选择后）：
+
+```ts
+Flashcat.setTrackingConsent(TrackingConsent.GRANTED);
+```
 
 <Warning>
 Trace header 也受同意状态控制。只有状态为 `GRANTED` 时，SDK 才会向请求注入可关联的 `traceparent` 和 `tracestate`。