# 场景化 API（默认 RTM）概览 (/zh-CN/solutions/one-to-one-live/rtm)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

1v1 指一对一视频通话和一对一音频通话，是社交和即时通信类 App 的必备功能。在陌生人社交领域，1v1 又可细分为 1v1 私密房和秀场转 1v1 两类玩法。

声网 1v1 私密房默认 RTM 方案基于场景化 API (CallAPI) 开发，包含 1v1 音视频、定向邀约、用户管理，及音频体验、计费策略推荐等最佳实践于一体，支持最快一周内上线，显著降低开发成本。

1v1 私密房场景解决方案支持如下两种玩法：

- 1v1 私密房。即用户根据头像、个人简介等选择感兴趣的其他用户，并发起 1v1 私密视频通话。
- 秀场转 1v1。直播过程中，观众可以向主播发起呼叫，然后和主播进行 1v1 私密视频通话。私密通话结束后，主播继续进行直播。可以作为秀场直播的一个付费玩法。

<OverviewActions actions={[
  { label: '下载', href: '/zh-CN/solutions/one-to-one-live/rtm/reference/downloads' },
  { label: '方案对比', href: '/zh-CN/solutions/one-to-one-live/rtm/reference/solution-compare' },
  { label: '客户端 API', href: '/zh-CN/api-reference/api?product=private-room&apiType=client' },
]} />

## 开始构建 [#开始构建]

<Cards>
  <Card title="快速开始" href="/zh-CN/solutions/one-to-one-live/rtm/get-started/run-example" description="运行示例或完成最小可用集成，快速验证核心流程。" />
  <Card title="构建功能" href="/zh-CN/solutions/one-to-one-live/rtm/build/setup-and-access/enable-service" description="按业务任务接入核心能力，并完成生产环境配置。" />
  <Card title="参考信息" href="/zh-CN/solutions/one-to-one-live/rtm/reference/downloads" description="查看版本、计费、限制、错误码、API 和兼容性说明。" />
</Cards>


## 场景简介 [#场景简介]

### 细分场景和玩法介绍 [#细分场景和玩法介绍]

本节介绍 1v1 私密房场景化 API（默认 RTM）方案支持的场景、细分场景及具体的玩法信息。

<DocsTable>
<thead>
<tr>
<th scope="col">大场景</th>
<th scope="col">细分场景</th>
<th scope="col">玩法介绍</th>
<th scope="col">实现功能</th>
</tr>
</thead>
<tbody>
<tr>
<td rowSpan={2}>1v1 私密房</td>
<td>定向呼叫</td>
<td>

- 主叫：发起呼叫 - 等待接听 - 视频通话 - 结束通话
- 被叫：收到呼叫 - 接听呼叫 - 视频通话 - 结束通话

</td>
<td>呼叫、接听、通话、挂断</td>
</tr>
<tr>
<td>随机匹配</td>
<td>

- 发起匹配
- 默认接听/授权接听
- 视频通话
- 结束通话

</td>
<td>匹配、接听、通话、挂断</td>
</tr>
<tr>
<td>秀场转 1v1</td>
<td>/</td>
<td>直播过程中，付费观众向主播发起呼叫，主播接受后转场 1v1 私密房；私密视频通话结束后，主播继续直播</td>
<td>

- 开播、看播
- 转场
- 呼叫、接听、通话、挂断

</td>
</tr>
</tbody>
</DocsTable>

### 角色介绍 [#角色介绍]

根据各业务场景的特点，1v1 私密房场景方案中会有如下角色：

| 角色 | 使用场景 | 描述 |
| --- | --- | --- |
| 主叫 | [product-overview-html-1-1-1 details](#table-slot-product-overview-html-1-1-1) | 视频通话呼叫发起者 |
| 被叫 | [product-overview-html-1-2-1 details](#table-slot-product-overview-html-1-2-1) | 视频通话接听者 |
| 主播 | 秀场转 1v1 | 创建直播间开启秀场直播的用户 |
| 普通观众 | 秀场转 1v1 | 加入直播间观看秀场直播的用户 |

<a id="table-slot-product-overview-html-1-1-1"></a>

**product-overview-html-1-1-1 details**

- 1v1 私密房
- 秀场转 1v1（即发起呼叫的直播观众）

<a id="table-slot-product-overview-html-1-2-1"></a>

**product-overview-html-1-2-1 details**

- 1v1 私密房
- 秀场转 1v1（即直播房间的主播）

## 平台支持 [#平台支持]

声网 1v1 私密房默认 RTM 方案支持 Android 和 iOS。

## 方案优势 [#方案优势]

声网 1v1 私密房默认 RTM 方案基于 1v1 场景化 API 搭建，同时将保证流畅、高清、秒接通等最佳效果的 API 进行整合，因此具有如下优势：

**易于集成**

- 易用：支持快速调试，一周快速上线
- 完整：覆盖一对一通话（呼叫、接通、挂断等）、计费逻辑参考、匹配逻辑参考、美颜、防薅羊毛、即时消息等功能模块
- 方便问题调查：上报机制完善，支持开发者通话日志定位问题

**实现效果**

- 流畅、高清的视频通话：针对全球区域弱网地区，均自适应最佳弱网策略
- 呼叫秒接通、秒出图：针对全球跨区通话，支持快速实现接通一对一视频通话的刚需
- 跨区域通话超低延迟：针对全球跨区通话，超低延迟支持
- 合理的计费策略逻辑：协助开发者计费更精准，让用户更满意

**数据监测**

- 提供各区域指标的上限和下限标准，和指导实现的最佳实践

## 计费 [#计费]

联系 sales@shengwang.cn 了解声网 1v1 私密房默认 RTM 方案的计费详情。