补充 publish_game_distribution_version 的 replayed 语义文档

- 说明返回三元组第三个值的含义与自然幂等键、请求摘要的关系
2026-10-08 11:14:15 +08:00
parent 07b3dbb40e
commit 5f084d0ca3
1 changed files with 7 additions and 0 deletions
@@ -1358,6 +1358,13 @@ impl SpacetimeClient {
        .await
    }

+    /// 统一发布一个版本，返回 `(game, version, replayed)`。
+    ///
+    /// 第三个返回值 `replayed` 表示这次请求命中了同一自然幂等键
+    /// `(game_id, idempotency_key, request_digest)`：服务端没有新建版本，回传的是既有作品与版本行。
+    /// 其中 `idempotency_key` 由 api-server 按 `(game_id, project_key, version_number)` 派生
+    /// （`version_number` 是客户端冻结的对外版本身份，`project_key` 只参与首次发布的作品身份派生），
+    /// `request_digest` 覆盖完整 metadata 与新图字节；同键异摘要会被拒绝，而不是静默重放。
    pub async fn publish_game_distribution_version(
        &self,
        input: GameDistributionPublishVersionRecordInput,