asc-game-center

使用 asc 管理 Game Center

通过 App Store Connect API 管理 Game Center 详情、成就和排行榜。

身份验证

asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8

如何导航（CAEOAS 可操作项）

每个 JSON 响应都包含一个 "affordances" 字段，其中提供了可直接运行的命令，且已填入 ID。从 Game Center 详情开始，导航至成就和排行榜。

{
  "id": "gc-abc123",
  "appId": "6443417124",
  "isArcadeEnabled": false,
  "affordances": {
    "getDetail": "asc game-center detail get --app-id 6443417124",
    "listAchievements": "asc game-center achievements list --detail-id gc-abc123",
    "listLeaderboards": "asc game-center leaderboards list --detail-id gc-abc123"
  }
}

典型工作流

为 App 设置 Game Center

# 1. Get the Game Center detail (find the detail ID)
asc game-center detail get --app-id 6443417124 --pretty

# 2. List existing achievements
asc game-center achievements list --detail-id gc-abc123 --pretty

# 3. Create a new achievement
asc game-center achievements create \
  --detail-id gc-abc123 \
  --reference-name "First Steps" \
  --vendor-identifier first_steps \
  --points 10 \
  --pretty

# 4. Create a leaderboard
asc game-center leaderboards create \
  --detail-id gc-abc123 \
  --reference-name "All Time High" \
  --vendor-identifier all_time_high \
  --score-sort-type DESC \
  --submission-type BEST_SCORE \
  --pretty

一览所有 Game Center 内容

DETAIL_ID=$(asc game-center detail get --app-id APP_ID | jq -r '.data[0].id')
asc game-center achievements list --detail-id "$DETAIL_ID" --output table
asc game-center leaderboards list --detail-id "$DETAIL_ID" --output table

清理 — 删除成就

# Copy the delete affordance from the achievement and run it
asc game-center achievements delete --achievement-id ach-abc123

命令

asc game-center detail get

获取 App 的 Game Center 配置。

标志	必需	说明
--app-id	是	App Store Connect App ID
--output table|json	否	输出格式（默认：json）
--pretty	否	美化 JSON 输出

asc game-center detail get --app-id 6443417124 --pretty
asc game-center detail get --app-id 6443417124 --output table

asc game-center achievements list

列出 Game Center 详情中的所有成就。

标志	必需	说明
--detail-id	是	Game Center 详情 ID
--output table|json	否	输出格式
--pretty	否	美化 JSON 输出

asc game-center achievements list --detail-id gc-abc123 --pretty
asc game-center achievements list --detail-id gc-abc123 --output table

asc game-center achievements create

创建新成就。

标志	必需	说明
--detail-id	是	Game Center 详情 ID
--reference-name	是	内部引用名称
--vendor-identifier	是	唯一标识符（例如 first_steps）
--points	是	成就的积分值
--show-before-earned	否	获得前显示成就（标志）
--repeatable	否	成就可重复获得（标志）
--pretty	否	美化 JSON 输出

asc game-center achievements create \
  --detail-id gc-abc123 \
  --reference-name "Speed Runner" \
  --vendor-identifier speed_runner \
  --points 50 \
  --repeatable

asc game-center achievements delete

删除成就。

标志	必需	说明
--achievement-id	是	要删除的成就 ID

asc game-center achievements delete --achievement-id ach-abc123

asc game-center leaderboards list

列出 Game Center 详情中的所有排行榜。

标志	必需	说明
--detail-id	是	Game Center 详情 ID
--output table|json	否	输出格式
--pretty	否	美化 JSON 输出

asc game-center leaderboards list --detail-id gc-abc123 --output table

asc game-center leaderboards create

创建新排行榜。

标志	必需	说明
--detail-id	是	Game Center 详情 ID
--reference-name	是	内部引用名称
--vendor-identifier	是	唯一标识符（例如 all_time_high）
--score-sort-type	是	ASC 或 DESC
--submission-type	是	BEST_SCORE 或 MOST_RECENT_SCORE
--pretty	否	美化 JSON 输出

asc game-center leaderboards create \
  --detail-id gc-abc123 \
  --reference-name "Speed Run" \
  --vendor-identifier speed_run \
  --score-sort-type ASC \
  --submission-type MOST_RECENT_SCORE

asc game-center leaderboards delete

删除排行榜。

标志	必需	说明
--leaderboard-id	是	要删除的排行榜 ID

asc game-center leaderboards delete --leaderboard-id lb-abc123

领域模型

GameCenterDetail — 应用的 Game Center 配置

• id — Game Center 详情 ID
• appId — 父级 App ID（由请求注入，API 不会返回）
• isArcadeEnabled — 是否启用了 Apple Arcade
• 可用操作：getDetail、listAchievements、listLeaderboards

GameCenterAchievement — 单个 Game Center 成就

• id — 成就 ID
• gameCenterDetailId — 父级详情 ID（已注入）
• referenceName — 内部名称
• vendorIdentifier — 唯一的 bundle 风格标识符
• points — 分值
• isShowBeforeEarned — 获得前是否可见
• isRepeatable — 是否可以多次获得
• isArchived — 是否已归档
• 可用操作：listAchievements、delete

GameCenterLeaderboard — 单个 Game Center 排行榜

• id — 排行榜 ID
• gameCenterDetailId — 父级详情 ID（已注入）
• referenceName — 内部名称
• vendorIdentifier — 唯一标识符
• scoreSortType — ASC 或 DESC
• submissionType — BEST_SCORE 或 MOST_RECENT_SCORE
• isArchived — 是否已归档
• 可用操作：listLeaderboards、delete

完整命令参考

所有标志和示例请参阅 commands.md。