/*@jsxRuntime automatic @jsxImportSource react*/ const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; function _createMdxContent(props) { const _components = Object.assign({ p: "p", strong: "strong", a: "a", h2: "h2", code: "code", h3: "h3", h4: "h4", pre: "pre" }, _provideComponents(), props.components); return _jsxs(_Fragment, { children: [_jsxs(_components.p, { children: ["你可以使用 ", _jsx(_components.strong, { children: "Epic在线服务（Epic Online Services）（EOS）" }), " ", _jsx(_components.a, { href: "/game-services/voice", children: "语音接口" }), "来创建和管理用户之间的语音聊天室。在比赛期间，或者在应用程序的大厅中，用户可以跨多个平台进行一对一或群组沟通。"] }), "\n", _jsxs(_components.p, { children: ["你可以使用语音Web API（取代EOS C SDK）来创建可信的服务器应用程序，以实施自定义的房间管理和授权。在调用语音Web API之前，请查看Web API", _jsx(_components.a, { href: "/web-api-ref", children: "概览" }), "中规定的标准、", _jsx(_components.a, { href: "/web-api-ref/connect-web-api", children: "身份验证" }), "和", _jsx(_components.a, { href: "/web-api-ref/web-api-error-codes-responses", children: "错误代码" }), "。"] }), "\n", _jsxs(_components.p, { children: ["就像", _jsx(_components.a, { href: "/game-services/voice", children: "语音C接口" }), "一样，语音Web API预期用于在", _jsx(_components.a, { href: "/game-services/voice", children: "可信的服务器" }), "上使用，并且需要禁用了 ", _jsx(_components.strong, { children: "userRequired" }), " 的策略。"] }), "\n", _jsx(_components.h2, { id: "语音web-api端点", children: "语音Web API端点" }), "\n", _jsx(_components.p, { children: _jsx(_components.code, { children: "https://api.epicgames.dev/rtc/" }) }), "\n", _jsx(_components.h2, { id: "创建房间令牌", children: "创建房间令牌" }), "\n", _jsx(_components.p, { children: "为了加入媒体服务器上的语音会议，用户需要提供房间令牌。" }), "\n", _jsxs(_components.p, { children: [_jsx(_components.code, { children: "createRoomToken" }), " 请求将会查询这些令牌中的 ", _jsx(_components.code, { children: "ProductUserIds" }), " 列表，使用玩家IP地址来选择最靠近玩家位置的服务器。玩家IP地址是可选的，但为了提供最佳用户体验，我们推荐包含此数据。因为靠近玩家位置的服务器在语音会话时的网络延迟更低。"] }), "\n", _jsxs(_components.p, { children: ["如果指定的 ", _jsx(_components.code, { children: "roomId" }), " 不存在，则会创建一个。"] }), "\n", _jsx(_components.p, { children: "结果中将包含玩家房间令牌以及托管语音会话的媒体服务器的端点。" }), "\n", _jsx(_components.h3, { id: "策略", children: "策略" }), "\n", _jsxs(_components.p, { children: ["客户端必须具有", _jsx(_components.a, { href: "/game-services/voice#policy-configurations", children: "Voice:createRoomToken策略" }), "。"] }), "\n", _jsx(_components.h3, { id: "房间令牌", children: "房间令牌" }), "\n", _jsx(_components.p, { children: "响应中包含的个体令牌应该只能与请求令牌的相应玩家(ProductUserId)共享，不对整个组可见，因为这会让被踢出房间的玩家有机会重新使用其他玩家的令牌重新进入房间。" }), "\n", _jsx(_components.h3, { id: "授权", children: "授权" }), "\n", _jsxs(_components.p, { children: ["此调用要求使用从", _jsx(_components.a, { href: "/web-api-ref/connect-web-api", children: "连接接口Web API" }), "获取的EOS客户端身份验证访问令牌来进行Bearer令牌授权。"] }), "\n", _jsx(_components.h3, { id: "请求", children: "请求" }), "\n", _jsxs("table", { children: [_jsxs("thead", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx(_components.strong, { children: "HTTP请求" }) }), _jsx("td", { colSpan: 3, children: _jsx(_components.code, { children: "POST /rtc/v1/{DeploymentId}/room/{RoomId}" }) })] }), _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "HTTP头" }) }) })] }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { colSpan: 2, children: _jsx("strong", { children: "数值" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "Authorization" }) }), _jsx("td", { colSpan: 2, children: _jsx("code", { children: "Bearer " }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "Content-Type" }) }), _jsx("td", { colSpan: 2, children: _jsx("code", { children: "application/json" }) })] })] }), _jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "路径参数" }) }) }) }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { children: _jsx("strong", { children: "类型" }) }), _jsx("td", { children: _jsx("strong", { children: "描述" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "DeploymentId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "EOS部署ID" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "RoomId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "选择的语音房间ID" })] })] }), _jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: "POST Body参数" }) }) }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { children: _jsx("strong", { children: "类型" }) }), _jsx("td", { children: _jsx("strong", { children: "描述" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "participants" }) }), _jsx("td", { children: "数组 " }), _jsxs("td", { children: [_jsx("code", { children: "EosRoomParticipantRequests" }), " 列表"] })] })] })] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "EosRoomParticipantRequests" }) }), "\n", _jsxs("table", { children: [_jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx(_components.strong, { children: "EosRoomParticipantRequests" }) }) }) }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { children: _jsx("strong", { children: "类型" }) }), _jsx("td", { children: _jsx("strong", { children: "描述" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "puid" }) }), _jsx("td", { children: "字符串" }), _jsxs("td", { children: ["EOS ", _jsx("code", { children: "ProductUserId" })] })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "clientIP" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "玩家的IP地址（即\"参与者\"）。服务会使用该数据为语音会话选择靠近玩家位置的服务器。如果不提供IP地址，服务会选择默认位置的服务器。这可能会导致玩家体验不佳：不靠近玩家位置的服务器可能会使玩家在语音会话时遭遇较高的网络延迟。" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "hardMuted" }) }), _jsx("td", { children: "布尔值" }), _jsx("td", { children: "参与者的初始禁言状态" })] })] })] }), "\n", _jsx(_components.h4, { id: "请求示例", children: "请求示例" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "curl -X \"POST\" \\ \"https://api.epicgames.dev/rtc/v1//room/\" \\\n-H \"accept: application/json\" \\\n-H \"Authorization: Bearer \" \\\n-H \"Content-Type: application/json\" \\\n-d \"{ \\\"participants\\\": [ { \\\"puid\\\": \\\"\\\",\\\"clientIp\\\": \\\"\\\", \\\"hardMuted\\\": false } ] }\"\n" }) }), "\n", _jsx(_components.h4, { id: "响应", children: "响应" }), "\n", _jsxs("table", { style: { width: '100%' }, children: [_jsxs("thead", { children: [_jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx(_components.strong, { children: "200 - OK: 成功" }) }) }), _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "HTTP头" }) }) })] }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { colSpan: 2, children: _jsx("strong", { children: "数值" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "Content-Type" }) }), _jsx("td", { colSpan: 2, children: _jsx("code", { children: "application/json" }) })] })] }), _jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "JSON Payload" }) }) }) }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { children: _jsx("strong", { children: "类型" }) }), _jsx("td", { children: _jsx("strong", { children: "描述" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "roomId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "语音房间ID" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "clientBaseUrl" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "用于加入语音会话的媒体服务器的URL" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "participants" }) }), _jsx("td", { children: "数组 " }), _jsxs("td", { children: [_jsx("code", { children: "EosRoomParticipantInfo" }), " 列表"] })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "deploymentId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "请求的部署ID" })] })] })] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "EosRoomParticipantInfo" }) }), "\n", _jsxs("table", { children: [_jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "EosRoomParticipantInfo" }) }) }) }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { children: _jsx("strong", { children: "类型" }) }), _jsx("td", { children: _jsx("strong", { children: "描述" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "puid" }) }), _jsx("td", { children: "字符串" }), _jsxs("td", { children: ["EOS ", _jsx("code", { children: "ProductUserId" })] })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "token" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "用于加入媒体服务器的ProductUserId的房间令牌。" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "hardMuted" }) }), _jsx("td", { children: "布尔值" }), _jsx("td", { children: "参与者的禁言状态" })] })] })] }), "\n", _jsx(_components.h4, { id: "响应示例", children: "响应示例" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-json", children: "{\n \"roomId\": \"\",\n \"participants\": [\n {\n \"puid\": \"\",\n \"token\": \"\",\n \"hardMuted\": false\n }\n ],\n \"clientBaseUrl\": \"\",\n \"deploymentId\": \"\"\n}\n" }) }), "\n", _jsx(_components.h2, { id: "移除参与者", children: "移除参与者" }), "\n", _jsxs(_components.p, { children: [_jsx(_components.code, { children: "removeParticipant" }), " 请求将从语音房间中移除玩家并撤销他们的房间令牌，从而防止他们再次使用现有令牌加入同一房间。"] }), "\n", _jsx(_components.h3, { id: "请求-1", children: "请求" }), "\n", _jsxs("table", { style: { width: '100%' }, children: [_jsxs("thead", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx(_components.strong, { children: "HTTP请求" }) }), _jsx("td", { colSpan: 2, children: _jsx(_components.code, { children: "DELETE /rtc/v1/{DeploymentId}/room/{RoomId}/participants/{ProductUserId}" }) })] }), _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "HTTP头" }) }) })] }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { colSpan: 2, children: _jsx("strong", { children: "数值" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "Authorization" }) }), _jsx("td", { colSpan: 2, children: "Bearer " })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "Content-Type" }) }), _jsx("td", { colSpan: 2, children: _jsx("code", { children: "application/json" }) })] })] }), _jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "路径参数" }) }) }) }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { children: _jsx("strong", { children: "类型" }) }), _jsx("td", { children: _jsx("strong", { children: "描述" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "DeploymentId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "EOS部署ID" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "RoomId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "玩家的房间ID" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "ProductUserId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "玩家的产品用户ID" })] })] })] }), "\n", _jsx(_components.h4, { id: "请求示例-1", children: "请求示例" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "curl -X \"DELETE\" \\ \"https://api.epicgames.dev/rtc/v1//room//participants/\" \\\n-H \"Authorization: Bearer\"\n" }) }), "\n", _jsx(_components.h4, { id: "响应-1", children: "响应" }), "\n", _jsx("table", { children: _jsx("thead", { children: _jsx("tr", { children: _jsxs("td", { colSpan: 3, children: [_jsx(_components.strong, { children: "HTTP Response 204 - 无内容。" }), " "] }) }) }) }), "\n", _jsx(_components.h4, { id: "响应示例-1", children: "响应示例" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "204 No Content\n" }) }), "\n", _jsx(_components.h2, { id: "修改参与者", children: "修改参与者" }), "\n", _jsx(_components.p, { children: "房间成员可以远程静音，比如可以对所有人静音，不受其自己的静音状态影响。" }), "\n", _jsx(_components.h3, { id: "请求-2", children: "请求" }), "\n", _jsxs("table", { children: [_jsxs("thead", { children: [_jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx(_components.code, { children: "POST /rtc/v1/{DeploymentId}/room/{RoomId}/participants/{ProductUserId}" }) }) }), _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "HTTP头" }) }) })] }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { colSpan: 2, children: _jsx("strong", { children: "数值" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "Authorization" }) }), _jsx("td", { colSpan: 2, children: "Bearer " })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "Content-Type" }) }), _jsx("td", { colSpan: 2, children: _jsx("code", { children: "application/json" }) })] })] }), _jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "路径参数" }) }) }) }), _jsxs("tbody", { children: [_jsxs("tr", { children: [_jsx("td", { children: _jsx("strong", { children: "名称" }) }), _jsx("td", { children: _jsx("strong", { children: "类型" }) }), _jsx("td", { children: _jsx("strong", { children: "描述" }) })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "DeploymentId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "EOS部署ID" })] }), _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "RoomId" }) }), _jsx("td", { children: "字符串" }), _jsx("td", { children: "选中的语音房间ID" })] })] }), _jsx("thead", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, children: _jsx("strong", { children: "POST Body参数" }) }) }) }), _jsx("tbody", { children: _jsxs("tr", { children: [_jsx("td", { children: _jsx("code", { children: "hardMuted" }) }), _jsx("td", { children: "布尔值" }), _jsxs("td", { children: ["禁言状态：", _jsx("code", { children: "true" }), " or ", _jsx("code", { children: "false" })] })] }) })] }), "\n", _jsx(_components.h4, { id: "请求示例-2", children: "请求示例" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "curl -X \"POST\" \\ \"https://api.epicgames.dev/rtc/api/v1//room//participants/\" \\\n-H \"Content-Type: application/json\" \\\n-d \"{\\\"hardMuted\\\":true}\"\n" }) }), "\n", _jsx(_components.h4, { id: "响应-2", children: "响应" }), "\n", _jsx("table", { children: _jsx("thead", { children: _jsx("tr", { children: _jsxs("td", { colSpan: 3, children: [_jsx(_components.strong, { children: "HTTP Response 204 - 无内容。" }), " "] }) }) }) }), "\n", _jsx(_components.h4, { id: "响应示例-2", children: "响应示例" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "204 No Content\n" }) })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components); return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, { children: _jsx(_createMdxContent, props) })) : _createMdxContent(props); } return { default: MDXContent };