此页面由 Cloud Translation API 翻译。

Rooms: create

创建聊天室。仅供游戏 SDK 内部使用。不支持直接调用此方法。立即尝试。

请求

HTTP 请求

POST https://www.googleapis.com/games/v1/rooms/create

参数

参数名称	值	说明
可选的查询参数
`language`	`string`	此方法返回的字符串的首选语言。

授权

此请求需要获得以下范围的授权：

范围
`https://www.googleapis.com/auth/games`

如需了解详情，请参阅身份验证和授权页面。

请求正文

在请求正文中，请按以下结构提供数据：

{
  "kind": "games#roomCreateRequest",
  "variant": integer,
  "invitedPlayerIds": [
    string
  ],
  "autoMatchingCriteria": {
    "kind": "games#roomAutoMatchingCriteria",
    "minAutoMatchingPlayers": integer,
    "maxAutoMatchingPlayers": integer,
    "exclusiveBitmask": long
  },
  "clientAddress": {
    "kind": "games#roomClientAddress",
    "xmppAddress": string
  },
  "networkDiagnostics": {
    "kind": "games#networkDiagnostics",
    "registrationLatencyMillis": integer,
    "androidNetworkType": integer,
    "androidNetworkSubtype": integer,
    "iosNetworkType": integer,
    "networkOperatorName": string,
    "networkOperatorCode": string
  },
  "capabilities": [
    string
  ],
  "requestId": long
}

属性名称	值	说明
`kind`	`string`	此资源类型的唯一标识。值始终是固定字符串 `games#roomCreateRequest`。
`variant`	`integer`	要播放的应用的变体 / 模式。这可以是任何整数值，也可以留空。您应使用少量变体，以尽可能扩大自动匹配池。
`invitedPlayerIds[]`	`list`	要邀请进入聊天室的玩家 ID。
`autoMatchingCriteria`	`nested object`	将玩家自动匹配到此聊天室中的条件。
`autoMatchingCriteria.kind`	`string`	此资源类型的唯一标识。值始终是固定字符串 `games#roomAutoMatchingCriteria`。
`autoMatchingCriteria.minAutoMatchingPlayers`	`integer`	应通过自动匹配功能添加到聊天室中的最少玩家数量。
`autoMatchingCriteria.maxAutoMatchingPlayers`	`integer`	应通过自动匹配功能添加到聊天室中的玩家数量上限。
`autoMatchingCriteria.exclusiveBitmask`	`long`	一个位掩码，表示自动匹配何时有效。与其他独占位掩码执行 AND 运算时，结果必须为零。可用于支持游戏中的专属角色。
`clientAddress`	`nested object`	创建聊天室的玩家的客户端地址。
`clientAddress.kind`	`string`	此资源类型的唯一标识。值始终是固定字符串 `games#roomClientAddress`。
`clientAddress.xmppAddress`	`string`	客户端在 Google 游戏 XMPP 网络上的 XMPP 地址。
`networkDiagnostics`	`nested object`	创建聊天室的客户端的网络诊断。
`networkDiagnostics.kind`	`string`	此资源类型的唯一标识。值始终是固定字符串 `games#networkDiagnostics`。
`networkDiagnostics.registrationLatencyMillis`	`integer`	客户端与 XMPP 服务器建立连接所用的时间（以毫秒为单位）。
`networkDiagnostics.androidNetworkType`	`integer`	Android 网络类型。
`networkDiagnostics.androidNetworkSubtype`	`integer`	Android 网络子类型。
`networkDiagnostics.iosNetworkType`	`integer`	`Reachability.h` 中定义的 iOS 网络类型。
`networkDiagnostics.networkOperatorName`	`string`	客户端网络连接的运营商名称。Android 设备：http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperatorName()（iOS：https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html#//apple_ref/occ/instp/CTCarrier/carrierName）
`networkDiagnostics.networkOperatorCode`	`string`	客户端网络连接的 MCC+MNC 代码。在 Android 上：http://developer.android.com/reference/android/telephony/TelephonyManager.html#getNetworkOperator()（对于 iOS），请参阅：https://developer.apple.com/library/ios/documentation/NetworkingInternet/Reference/CTCarrier/Reference/Reference.html
`capabilities[]`	`list`	此客户端支持实时通信的功能。
`requestId`	`long`	随机生成的数字 ID。此数字用于服务器，以确保请求在重试时得到正确处理。

响应

如果成功，此方法将在响应正文中返回 Rooms 资源。

试试看！

请使用下面的 API Explorer 针对实际数据调用此方法，然后查看响应。