tencent cloud

直播 SDK

动态与公告
TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
新手指引
产品简介
产品概述
产品优势
性能数据
基本概念
购买指南
TRTC Live 价格总览
Live 视频直播计费说明
开通服务（TUILiveKit）
Demo 体验
Demo 体验指引
跑通 Demo（TUILiveKit）
接入指南
视频直播
准备工作
主播开播
观众观看
直播列表
语聊房
准备工作
主播开播
观众观看
直播列表
推流助手
推流助手（Electron 桌面应用）
推流助手（Web 桌面浏览器）
直播监播
监播页面（Web 桌面浏览器 React 版）
监播页面（Web 桌面浏览器 Vue 版）
UI 自定义
直播视频组件
视频源编辑组件
观众列表组件
聊天弹幕组件
媒体源配置面板
连麦管理面板
直播送礼组件
无 UI 集成
搭建视频直播
搭建语聊房
功能指南
关注主播（TUILiveKit）
至臻画质（TUILiveKit）
输入媒体流进房（TUILiveKit）
礼物系统（TUILiveKit）
客户端 API
Android
iOS
Web
服务端 API（TUILiveKit）
账号系统
REST API
第三方回调
错误码（TUILiveKit）
常见问题
平台编译
用户鉴权
云直播推拉流 SDK
产品简介
购买指南
Demo 体验
免费测试
SDK 下载
License 管理
高级功能
客户端 API
常见问题
无 UI 集成方案
API 文档
OSS information
OSS Attribution Notice
文档直播 SDK云直播推拉流 SDK高级功能设定画面质量

设定画面质量

聚焦模式
字号
最后更新时间： 2024-01-13 15:53:49

示例代码

针对开发者的接入反馈的高频问题，腾讯云提供有更加简洁的 API-Example 工程，方便开发者可以快速的了解相关 API 的使用，欢迎使用。
所属平台
GitHub 地址
iOS
Android

功能介绍

LiteAVSDK 通过 V2TXLivePusher 提供的setVideoQuality接口来设定画面质量：

接口定义

可以通过setVideoQuality设置推流视频分辨率，以及宽高比模式（横屏 / 竖屏）。
public abstract int setVideoQuality(V2TXLiveVideoEncoderParam param);

参数

参数
类型
含义
param
视频编码参数。
V2TXLiveVideoResolution 枚举值：
取值
含义
V2TXLiveVideoResolution160x160
分辨率 160*160，码率范围：100Kbps ~ 150Kbps，帧率: 15fps
V2TXLiveVideoResolution270x270
分辨率 270*270，码率范围：200Kbps ~ 300Kbps，帧率：15fps
V2TXLiveVideoResolution480x480
分辨率 480*480，码率范围：350Kbps ~ 525Kbps，帧率：15fps
V2TXLiveVideoResolution320x240
分辨率 320*240，码率范围：250Kbps ~ 375Kbps，帧率：15fps。
V2TXLiveVideoResolution480x360
分辨率 480*360，码率范围：400Kbps ~ 600Kbps，帧率：15fps
V2TXLiveVideoResolution640x480
分辨率 640*480，码率范围：600Kbps ~ 900Kbps，帧率：15fps
V2TXLiveVideoResolution320x180
分辨率 320*180，码率范围：250Kbps ~ 400Kbps，帧率：15fps
V2TXLiveVideoResolution480x270
分辨率 480*270，码率范围：350Kbps ~ 550Kbps，帧率：15fps
V2TXLiveVideoResolution640x360
分辨率 640*360，码率范围：500Kbps ~ 900Kbps，帧率：15fps
V2TXLiveVideoResolution960x540
分辨率 960*540，码率范围：800Kbps ~ 1500Kbps，帧率：15fps
V2TXLiveVideoResolution1280x720
分辨率 1280*720，码率范围：1000Kbps ~ 1800Kbps，帧率：15fps
V2TXLiveVideoResolution1920x1080
分辨率 1920*1080，码率范围：2500Kbps ~ 3000Kbps，帧率：15fps

V2TXLiveVideoResolutionMode 枚举值：
取值
含义
V2TXLiveVideoResolutionModeLandscape
横屏模式下的分辨率：V2TXLiveVideoResolution640_360 + V2TXLiveVideoResolutionModeLandscape = 640x360
V2TXLiveVideoResolutionModePortrait
竖屏模式下的分辨率：V2TXLiveVideoResolution640_360 + V2TXLiveVideoResolutionModePortrait = 360x640

参数设定建议

应用场景
resolution
resolutionMode
秀场直播
V2TXLiveVideoResolution960x540
V2TXLiveVideoResolution1280x720
横屏或者竖屏
手游直播
V2TXLiveVideoResolution1280x720
横屏或者竖屏
连麦（主画面）
V2TXLiveVideoResolution640x360
横屏或者竖屏
连麦（小画面）
V2TXLiveVideoResolution480x360
横屏或者竖屏
蓝光直播
V2TXLiveVideoResolution1920x1080
横屏或者竖屏

注意事项

为了连麦更流畅，进入连麦状态后请调用 setVideoQuality() 将 quality 挡位设置为V2TXLiveVideoResolution640x360（主播）或 V2TXLiveVideoResolution480x360（连麦观众），结束连麦状态后可以调用 setVideoQuality() 将 quality 挡位恢复为连麦前的值。

常见问题

1. 为什么观众端看到的画面没有主播端清晰？

主播端看到的画面，是从摄像头采集的原始画面，经过前处理（美颜、镜像、裁剪等操作）后直接渲染给主播观看，所以清晰度是最高的。而观众端看到的是经过编码器压缩再解码的画面，由于编码本身会降低压缩质量（视频码率设置的越低，压缩程度越严重），所以观众端看到的画面会比主播端清晰度低。

2. 为什么 V2TXLivePusher 推出来的流会有368 × 640或者544 × 960这样的分辨率?

在开启硬件加速后，您可能会发现诸如368 × 640或者544 × 960此类“不完美”分辨率，这是由于部分硬编码器要求像素能被16整除所致，属于正常现象，您可以通过设置播放端的填充模式解决“小黑边”问题。
上一篇: 配置查看 License下一篇: 自定义采集和渲染

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈