Back to Details

asc-game-center

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Game Center with 
asc

使用
asc
管理Game Center

Manage Game Center detail, achievements, and leaderboards through the App Store Connect API.
通过App Store Connect API管理Game Center详情、成就和排行榜。

Authentication

身份验证

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

How to Navigate (CAEOAS Affordances)

导航方法（CAEOAS 功能入口）

Every JSON response contains an 
"affordances"
field with ready-to-run commands — IDs already filled in. Start from the Game Center detail and navigate to achievements and leaderboards.
json
{
  "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"
  }
}
每个JSON响应都包含一个
"affordances"
字段，其中包含已填充好ID的可直接运行命令。从Game Center详情开始，可导航至成就和排行榜。
json
{
  "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"
  }
}

Typical Workflow

典型工作流程

Set up Game Center for an app

为应用设置Game Center

bash
undefined
bash
undefined

1. Get the Game Center detail (find the detail ID)

1. 获取Game Center详情（找到详情ID）

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

2. List existing achievements

2. 列出已有成就

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

3. Create a new achievement

3. 创建新成就

asc game-center achievements create
--detail-id gc-abc123
--reference-name "First Steps"
--vendor-identifier first_steps
--points 10
--pretty
asc game-center achievements create
--detail-id gc-abc123
--reference-name "First Steps"
--vendor-identifier first_steps
--points 10
--pretty

4. Create a leaderboard

4. 创建排行榜

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
undefined
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
undefined

View all Game Center content at a glance

一键查看所有Game Center内容

bash
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
bash
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

Clean up — delete an achievement

清理操作 — 删除成就

bash
undefined
bash
undefined

Copy the delete affordance from the achievement and run it

从成就信息中复制删除命令并运行

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

Commands

命令说明

asc game-center detail get

asc game-center detail get

Get Game Center configuration for an app.
FlagRequiredDescription
--app-id
yesApp Store Connect app ID
--output table|json
noOutput format (default: json)
--pretty
noPretty-print JSON
bash
asc game-center detail get --app-id 6443417124 --pretty
asc game-center detail get --app-id 6443417124 --output table
获取应用的Game Center配置。
参数是否必填说明
--app-id
是App Store Connect应用ID
--output table|json
否输出格式（默认：json）
--pretty
否格式化输出JSON
bash
asc game-center detail get --app-id 6443417124 --pretty
asc game-center detail get --app-id 6443417124 --output table

asc game-center achievements list

asc game-center achievements list

List all achievements for a Game Center detail.
FlagRequiredDescription
--detail-id
yesGame Center detail ID
--output table|json
noOutput format
--pretty
noPretty-print JSON
bash
asc game-center achievements list --detail-id gc-abc123 --pretty
asc game-center achievements list --detail-id gc-abc123 --output table
列出指定Game Center详情下的所有成就。
参数是否必填说明
--detail-id
是Game Center详情ID
--output table|json
否输出格式
--pretty
否格式化输出JSON
bash
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

asc game-center achievements create

Create a new achievement.
FlagRequiredDescription
--detail-id
yesGame Center detail ID
--reference-name
yesInternal reference name
--vendor-identifier
yesUnique identifier (e.g. 
first_steps
)
--points
yesPoint value for the achievement
--show-before-earned
noShow achievement before earned (flag)
--repeatable
noAchievement can be earned multiple times (flag)
--pretty
noPretty-print JSON
bash
asc game-center achievements create \
  --detail-id gc-abc123 \
  --reference-name "Speed Runner" \
  --vendor-identifier speed_runner \
  --points 50 \
  --repeatable
创建新成就。
参数是否必填说明
--detail-id
是Game Center详情ID
--reference-name
是内部参考名称
--vendor-identifier
是唯一标识符（例如
first_steps
）
--points
是成就的积分值
--show-before-earned
否解锁前显示成就（开关参数）
--repeatable
否成就可多次解锁（开关参数）
--pretty
否格式化输出JSON
bash
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

asc game-center achievements delete

Delete an achievement.
FlagRequiredDescription
--achievement-id
yesAchievement ID to delete
bash
asc game-center achievements delete --achievement-id ach-abc123
删除成就。
参数是否必填说明
--achievement-id
是要删除的成就ID
bash
asc game-center achievements delete --achievement-id ach-abc123

asc game-center leaderboards list

asc game-center leaderboards list

List all leaderboards for a Game Center detail.
FlagRequiredDescription
--detail-id
yesGame Center detail ID
--output table|json
noOutput format
--pretty
noPretty-print JSON
bash
asc game-center leaderboards list --detail-id gc-abc123 --output table
列出指定Game Center详情下的所有排行榜。
参数是否必填说明
--detail-id
是Game Center详情ID
--output table|json
否输出格式
--pretty
否格式化输出JSON
bash
asc game-center leaderboards list --detail-id gc-abc123 --output table

asc game-center leaderboards create

asc game-center leaderboards create

Create a new leaderboard.
FlagRequiredDescription
--detail-id
yesGame Center detail ID
--reference-name
yesInternal reference name
--vendor-identifier
yesUnique identifier (e.g. 
all_time_high
)
--score-sort-type
yes
ASC
or 
DESC
--submission-type
yes
BEST_SCORE
or 
MOST_RECENT_SCORE
--pretty
noPretty-print JSON
bash
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
创建新排行榜。
参数是否必填说明
--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
bash
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

asc game-center leaderboards delete

Delete a leaderboard.
FlagRequiredDescription
--leaderboard-id
yesLeaderboard ID to delete
bash
asc game-center leaderboards delete --leaderboard-id lb-abc123
删除排行榜。
参数是否必填说明
--leaderboard-id
是要删除的排行榜ID
bash
asc game-center leaderboards delete --leaderboard-id lb-abc123

Domain Models

领域模型

GameCenterDetail
 — Game Center configuration for an app
  • id
    — Game Center detail ID
  • appId
    — parent App ID (injected from request, not returned by API)
  • isArcadeEnabled
    — whether Apple Arcade is enabled
  • Affordances: 
    getDetail
    , 
    listAchievements
    , 
    listLeaderboards
GameCenterAchievement
 — A single Game Center achievement
  • id
    — achievement ID
  • gameCenterDetailId
    — parent detail ID (injected)
  • referenceName
    — internal name
  • vendorIdentifier
    — unique bundle-style identifier
  • points
    — point value
  • isShowBeforeEarned
    — visible before earned
  • isRepeatable
    — can be earned multiple times
  • isArchived
    — whether archived
  • Affordances: 
    listAchievements
    , 
    delete
GameCenterLeaderboard
 — A single Game Center leaderboard
  • id
    — leaderboard ID
  • gameCenterDetailId
    — parent detail ID (injected)
  • referenceName
    — internal name
  • vendorIdentifier
    — unique identifier
  • scoreSortType
    — 
    ASC
    or 
    DESC
  • submissionType
    — 
    BEST_SCORE
    or 
    MOST_RECENT_SCORE
  • isArchived
    — whether archived
  • Affordances: 
    listLeaderboards
    , 
    delete
GameCenterDetail
 — 应用的Game Center配置
  • id
    — Game Center详情ID
  • appId
    — 父应用ID（由请求注入，API不返回）
  • isArcadeEnabled
    — 是否启用Apple Arcade
  • 功能入口：
    getDetail
    、
    listAchievements
    、
    listLeaderboards
GameCenterAchievement
 — 单个Game Center成就
  • id
    — 成就ID
  • gameCenterDetailId
    — 父详情ID（由请求注入）
  • referenceName
    — 内部名称
  • vendorIdentifier
    — 唯一包样式标识符
  • 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

Full Command Reference

完整命令参考

See commands.md for all flags and examples.
查看commands.md获取所有参数和示例。