DOC-FULL-008：iOS 事件导出示例 #109

New Issue

wangdl · 2026-06-10T21:18:33+08:00

wangdl commented

2026-06-10 21:18:33 +08:00

目标

提供 iOS 如何调用 Rust V2 事件链路的示例代码 / 文档。

示例流程

openReadingSessionV2
→ heartbeatV2
→ recordPositionChangedV2
→ recordMarkedAsReadV2
→ closeReadingSessionV2
→ exportPendingEventsV2
→ iOS 转 UploadItem
→ iOS 写入 ReadingEventUploadQueue
→ ackEventsV2

必须强调

Rust 不上传 API。
Rust 不知道 readingTargetType。
iOS 转 UploadItem 时补 readingTargetType / platform / appVersion / timezone。
iOS 写入本地上传队列成功后才 ack。
ack 不等 API 上传成功。

验收标准

新增 docs/ios-reading-event-v2-integration.md。
包含 Swift 伪代码或示例。
包含 export / queue / ack 顺序。
包含错误处理。
包含 mark failed 示例。
能指导 M-IOS-INFO 接入。

## 目标提供 iOS 如何调用 Rust V2 事件链路的示例代码 / 文档。 ## 示例流程 ``` openReadingSessionV2 → heartbeatV2 → recordPositionChangedV2 → recordMarkedAsReadV2 → closeReadingSessionV2 → exportPendingEventsV2 → iOS 转 UploadItem → iOS 写入 ReadingEventUploadQueue → ackEventsV2 ``` ## 必须强调 1. Rust 不上传 API。 2. Rust 不知道 readingTargetType。 3. iOS 转 UploadItem 时补 readingTargetType / platform / appVersion / timezone。 4. iOS 写入本地上传队列成功后才 ack。 5. ack 不等 API 上传成功。 ## 验收标准 1. 新增 docs/ios-reading-event-v2-integration.md。 2. 包含 Swift 伪代码或示例。 3. 包含 export / queue / ack 顺序。 4. 包含错误处理。 5. 包含 mark failed 示例。 6. 能指导 M-IOS-INFO 接入。

wangdl added this to the M-DOC-FULL：Document Runtime 完整阅读内核与学习事件协议 milestone 2026-06-10 21:18:33 +08:00

wangdl added the

priority:p0

area:document-runtime

repo:document-runtime

labels 2026-06-10 21:18:33 +08:00

Sign in to join this conversation.