动态与公告

公告

新手指南

产品简介

产品概述

子产品简介

基本概念

产品功能

应用场景

产品优势

使用限制

购买指南

计费概述

基础服务费

增值服务费

预付费资源包

购买流程

计费变更

退款说明

账单查询

续费说明

欠费停服说明

计费常见问题

标准直播

概述

应用场景

快速入门

SDK 接入说明

快直播（超低延时直播）

概述

快直播和标准直播区别

应用场景

快速入门

SDK 接入说明

云导播台

概述

应用场景

功能区介绍

云导播台管理

通用云导播

配置节目单和自动导播

控制台指南

控制台介绍

概览

域名管理

流管理

资源包管理

AI 智能

功能配置

拉流转推

计费用量

业务监控

常用工具

无忧直播

CAM 访问控制

功能实践

直播推流与播放

直播增值功能

典型场景实践

云端原生录制

直播安全

海外直播

回调事件消息通知

常见第三方工具指南

SDK 实践

0. SDK 接入引导

1. 推流

2. 播放

3. 高级功能

API 文档

History

Introduction

API Category

Making API Requests

Live Pad APIs

Live Stream Mix APIs

Time Shifting APIs

Monitoring Data Query APIs

Billing Data Query APIs

Live Transcoding APIs

Delayed Playback Management APIs

Domain Name Management APIs

Watermark Management APIs

Certificate Management APIs

Stream Pulling APIs

Recording Management APIs

Live Callback APIs

Screencapturing and Porn Detection APIs

Authentication Management APIs

Live Stream Management APIs

Data Types

Error Codes

运维指南

优化视频卡顿

推流失败问题排查

播放失败问题排查

CLS 协助直播问题排查

直播延迟问题排查

拉流视频质量不清晰问题排查

COS bucket 授权给直播实现截图存储

故障处理

直播混流报错：InvalidParameter.OtherError

常见问题

服务地区相关

直播基础相关

推流播放相关

直播计费相关

直播海外相关

直播录制相关

云端混流相关

域名配置相关

云导播台相关

适配苹果 ATS 相关

服务等级协议

云直播服务等级协议

CSS 政策

隐私协议

数据处理和安全协议

词汇表

统计并发在线人数

PDF

聚焦模式

字号

最后更新时间： 2025-06-19 15:32:32

统计并发在线人数有两种方式，请根据播放协议的不同，选择适合您的统计方式：
方式一：播放协议为 RTMP 和 FLV
若播放协议为 RTMP 和 FLV，并发连接数即在线人数，可以通过控制台直接查看在线人数，具体操作请参见 文档 指引；也可以通过调用云直播 API 3.0 查询流播放信息列表的接口 获取在线流观看人数。
方式二：播放协议为 HLS
若播放协议为 HLS，由于 HLS 协议的短连接属性，并发用户数单从云端统计并不准确，需通过用户端播放请求地址携带 UUID 唯一字符串，并在云端开启统计实现。以下介绍播放协议为 HLS 时统计并发用户数的功能实践方案。
用户端
本方案基于 UUID 实现，该唯一字符串由客户应用服务器生成，并作为请求参数附加在播放 URL 地址后。每位用户会有一个唯一的 UUID。
播放 URL 示例：
http(s)://${your_domain_name}/${path}/${to}/${stream}/${playlist_name}.m3u8?uuid=c44ada05-3431-442f-9233-cb245d3624c8
或
http(s)://${your_domain_name}/${app_name}/${stream_name}.m3u8?uuid=2c2b59d0-e0c7-4877-9823-e4965d92f7bf
云端支持
您可以 提交工单 来支持 HLS 并发用户数按 UUID 统计。
接口描述
接口请求域名：live.tencentcloudapi.com。
该接口查询 HLS 并发在线人数统计信息，包括访问次数、在线人数、流量。 
输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
参数名称
必选
类型
描述
Action
是
String
﻿公共参数，本接口取值：DescribeHLSConcurrentUserInfo。
Version
是
String
﻿公共参数，本接口取值：2018-08-01。
Region
否
String
﻿公共参数，本接口不需要传递此参数。
StartTime
是
String
UTC 开始时间，格式为：yyyy-mm-ddTHH:MM:SSZ，参考 ISO日期格式。
例如：北京时间2019-01-08 10:00:00，对应 UTC 时间为：2019-01-08T10:00:00+08:00。
支持最近一个月的查询。
示例值：2006-01-02T15:04:05Z
EndTime
是
String
UTC 结束时间，格式为：yyyy-mm-ddTHH:MM:SSZ，参考 ISO日期格式。
例如：北京时间2019-01-08 10:00:00，对应 UTC 时间为：2019-01-08T10:00:00+08:00。
支持最近一个月的查询，开始时间和结束时间查询跨度不超过六个小时。
示例值：2006-01-02T15:04:05Z
PlayDomains.N
否
Array of String
播放域名列表，为空则默认查全部域名。
示例值：testplay.com
StreamNames.N
否
Array of String
流名称列表，为空则默认查全部流。
直推模式下查询流名称 StreamName 字段取值方式(streamid 为直推流 id )：
hls：
多码率：streamid_子码率模板名
单码率转码：streamid_模板名
非转码：streamid
dash:
单码率转码：streamid_模板名
非转码：streamid
示例值：test
输出参数
参数名称
类型
描述
DataInfoList
Array of HLSConcurrentUserInfo
HLS 直播并发人数统计信息。
RequestId
String
唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
示例
输入示例
查询 HLS 并发在线统计人数信息。
POST / HTTP/1.1
Host: live.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeHLSConcurrentUserInfo
<公共请求参数>
﻿
{"StartTime": "2022-10-12T14:00:00+08:00",
    "EndTime": "2022-10-12T15:10:00+08:00"}
输出示例
{
    "Response": {
        "DataInfoList": [
            {
                "Flux": 2893,
                "OnlineNums": 1,
                "RequestCount": 11,
                "Bandwidth": 123,
                "Time": "2022-10-12T14:35:00+08:00"
            }
        ],
        "RequestId": "b725570a-c1f1-4df7-b864-5ec3a9326cc0"
    }
}
开发者资源
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
﻿Tencent Cloud SDK 3.0 for Python﻿
﻿Tencent Cloud SDK 3.0 for Java﻿
﻿Tencent Cloud SDK 3.0 for PHP﻿
﻿Tencent Cloud SDK 3.0 for Go﻿
﻿Tencent Cloud SDK 3.0 for Node.js﻿
﻿Tencent Cloud SDK 3.0 for .NET﻿
﻿Tencent Cloud SDK 3.0 for C++﻿
命令行工具
﻿Tencent Cloud CLI 3.0﻿
错误码
以下仅列出接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
错误码
描述
FailedOperation
操作失败。
FailedOperation.NotFound
找不到记录。
InternalError
内部错误。
InvalidParameter
参数错误。
ResourceNotFound.ForbidService
用户被禁用。
ResourceNotFound.FreezeService
用户服务被冻结。
ResourceNotFound.StopService
账号停服，请先冲正开通服务后再操作。
ResourceNotFound.UserDisableService
用户主动停服。

帮助和支持

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

您也可以联系销售或提交工单以寻求帮助。

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

文档反馈

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：DescribeHLSConcurrentUserInfo。
Version	是	String	公共参数，本接口取值：2018-08-01。
Region	否	String	公共参数，本接口不需要传递此参数。
StartTime	是	String	UTC 开始时间，格式为：yyyy-mm-ddTHH:MM:SSZ，参考 ISO日期格式。例如：北京时间2019-01-08 10:00:00，对应 UTC 时间为：2019-01-08T10:00:00+08:00。支持最近一个月的查询。示例值：2006-01-02T15:04:05Z
EndTime	是	String	UTC 结束时间，格式为：yyyy-mm-ddTHH:MM:SSZ，参考 ISO日期格式。例如：北京时间2019-01-08 10:00:00，对应 UTC 时间为：2019-01-08T10:00:00+08:00。支持最近一个月的查询，开始时间和结束时间查询跨度不超过六个小时。示例值：2006-01-02T15:04:05Z
PlayDomains.N	否	Array of String	播放域名列表，为空则默认查全部域名。示例值：testplay.com
StreamNames.N	否	Array of String	流名称列表，为空则默认查全部流。直推模式下查询流名称 StreamName 字段取值方式(streamid 为直推流 id )： hls：多码率：streamid_子码率模板名单码率转码：streamid_模板名非转码：streamid dash: 单码率转码：streamid_模板名非转码：streamid 示例值：test

错误码	描述
FailedOperation	操作失败。
FailedOperation.NotFound	找不到记录。
InternalError	内部错误。
InvalidParameter	参数错误。
ResourceNotFound.ForbidService	用户被禁用。
ResourceNotFound.FreezeService	用户服务被冻结。
ResourceNotFound.StopService	账号停服，请先冲正开通服务后再操作。
ResourceNotFound.UserDisableService	用户主动停服。

tencent cloud

云直播

统计并发在线人数

方式一：播放协议为 RTMP 和 FLV

方式二：播放协议为 HLS

用户端

云端支持

接口描述

输入参数

输出参数

示例

输入示例

输出示例

开发者资源

SDK

命令行工具

错误码

帮助和支持