# 秀场直播自适应高清视频 (/zh-CN/solutions/showroom/build/hq-video)

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

为了提升直播间视频观看和互动体验，声网推出了自适应高清视频策略。

该策略会根据设备性能和网络质量，自动调整视频属性，实现高清且流畅的视频效果。你只需设置初始的视频分辨率、帧率和码率，无需考虑后续的调整逻辑。本文将详细介绍如何使用自适应高清视频策略，以提供优质的直播视频体验。

## 使用步骤 [#使用步骤]

### 1. 获取 SDK [#1-获取-sdk]

自适应高清视频策略暂时仅在 v4.1.x 系列的 RTC SDK 中支持。开始前，请[联系技术支持](https://ticket.shengwang.cn/)获取 v4.1.x 系列的 RTC SDK。

### 2. 设置视频分辨率、帧率、码率 [#2-设置视频分辨率帧率码率]

<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" />
通过 [`setVideoEncoderConfiguration`](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengine_setvideoencoderconfiguration) 方法中 `config` 参数中的 `dimensions`、`frameRate`、`bitrate` 字段设置主播的视频编码分辨率、帧率、码率。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" />
通过 [`setVideoEncoderConfiguration`](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_setvideoencoderconfiguration) 方法中 `config` 参数中的 `dimensions`、`frameRate`、`bitrate` 字段设置主播的视频编码分辨率、帧率、码率。
<_PlatformProcessedMarker close="true" />
</_PlatformTabsGroup>

在秀场直播场景下，声网建议码率保持为 `bitrate` 字段的默认值（`STANDARD_BITRATE(0)`），其他推荐取值如下表：

<DocsTable>
<thead>
<tr>
<th scope="col">秀场直播子场景</th>
<th scope="col">房间内角色</th>
<th scope="col">用户所在地</th>
<th scope="col">视频分辨率</th>
<th scope="col">视频帧率 (fps)</th>
</tr>
</thead>
<tbody>
<tr>
<td rowSpan={3}>单人直播 只有一个房主的视频画面</td>
<td rowSpan={3}>房主</td>
<td>中国（包含港澳台）、日韩、北美、欧洲</td>
<td>1080P</td>
<td>24</td>
</tr>
<tr>
<td>东南亚、印巴地区、中东北非、拉美（包含中美洲、墨西哥等）</td>
<td>720P</td>
<td>24</td>
</tr>
<tr>
<td>其他地区</td>
<td>540P</td>
<td>24</td>
</tr>
<tr>
<td rowSpan={4}>**观众**与房主连麦 房主视频画面大屏，连麦观众视频画面小屏</td>
<td rowSpan={3}>房主</td>
<td>中国（包含港澳台）、日韩、北美、欧洲</td>
<td>1080P</td>
<td>24</td>
</tr>
<tr>
<td>东南亚、印巴地区、中东北非、拉美（包含中美洲、墨西哥等）</td>
<td>720P</td>
<td>24</td>
</tr>
<tr>
<td>其他地区</td>
<td>540P</td>
<td>24</td>
</tr>
<tr>
<td>连麦观众</td>
<td>全球</td>
<td>180P</td>
<td>15</td>
</tr>
<tr>
<td>**房主**跨直播间 PK 连麦 两位房主的视频画面大小 1:1</td>
<td>房主</td>
<td>全球</td>
<td>540P</td>
<td>24</td>
</tr>
</tbody>
</DocsTable>

分辨率数值说明：

- 1080P：1920 × 1080。
- 720P：1280 × 720。
- 540P：960 × 540。
- 180P：320 × 180。

:::warning[注意]
每次切换秀场直播的子场景时，例如从单人直播切换到观众与房主连麦，你需要重新调用 `setVideoEncoderConfiguration` 来设置视频编码分辨率和其他属性，以满足表格中的要求。这样可以确保在不同的子场景下，视频编码属性符合所需的数值要求。
:::

### 3. 开启自适应高清 [#3-开启自适应高清]

按照如下步骤开启自适应高清视频策略：

<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" />
1. 调用 [`setParameters`](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setparameters) 并设置参数 `parameters` 为 `"che.video.auto_adjust_resolution" : { "auto_adjust_resolution_flag": 1 }`，以开启高清视频的设备性能自适应策略。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" />
1. 调用 [`setParameters`](/zh-CN/api-reference/rtc/ios/network#api_irtcengine_setparameters) 并设置参数 `parameters` 为 `"che.video.auto_adjust_resolution" : { "auto_adjust_resolution_flag": 1 }`，以开启高清视频的设备性能自适应策略。
<_PlatformProcessedMarker close="true" />
</_PlatformTabsGroup>

2. [联系技术支持](https://ticket.shengwang.cn/)，开启配套的网络质量自适应策略。

完成如上步骤后，自适应高清视频策略才将完全生效。该策略会根据设备性能和网络质量，自动调整你上一步设置的视频分辨率、帧率、码率，实现高清且流畅的视频效果。

## 注意事项 [#注意事项]

- 为保证自适应高清视频策略的效果最佳，请使用声网模块采集视频，而非[自定义视频采集](/zh-CN/realtime-media/rtc/build/video/custom-video-source)。
- 根据本文操作后，如果依然有部分观众反映视频卡顿，那么你需要对视频分辨率进一步降级。思路如下：视频卡顿的观众设置订阅主播的视频小流，主播通过开启视频双流模式并设置视频小流的视频分辨率等属性，以提供一路分辨率、帧率、码率较低的视频流给条件较差的观众观看。具体操作较为复杂，如果你确实有需要，请[联系技术支持](https://ticket.shengwang.cn/)。