1. 接口描述
接口请求域名： trro.tencentcloudapi.com 。
获取设备会话数据详单
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：DescribeDeviceSessionDetails。 |
| Version | 是 | String | 公共参数，本接口取值：2022-03-25。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| SessionId | 是 | String | 会话ID 示例值：f3glr49ry0i0xlm7 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Details | Array of SessionDeviceDetail | 按设备区分的会话详细数据 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 示例1
输入示例
POST / HTTP/1.1
Host: trro.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDeviceSessionDetails
<公共请求参数>
{
"SessionId": "c52cc0cc-3663-467b-a6d1-2f01d20ad7ae-1"
}输出示例
{
"Response": {
"RequestId": "0000etst1",
"Details": [
{
"DeviceType": "field",
"StartTime": 1731399569,
"EndTime": 1731399627,
"SessionId": "c52cc0cc-3663-467b-a6d1-2f01d20ad7ae-1",
"Rate": [
0,
0,
267,
213,
411,
562,
432,
617,
626,
709,
572,
569,
493,
540,
709,
681,
652,
732,
681,
714,
659,
690,
751,
719,
680,
541,
629,
759,
533,
416
],
"Fps": [
0,
0,
15,
19,
19,
19,
18,
19,
19,
19,
18,
19,
18,
20,
20,
20,
19,
19,
19,
19,
19,
19,
19,
19,
19,
17,
19,
21,
19,
18
],
"Lost": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"NetworkLatency": [
-1,
-1,
100,
326,
93,
89,
72,
79,
80,
91,
104,
503,
93,
76,
72,
72,
80,
88,
77,
77,
79,
89,
83,
89,
81,
79,
80,
82,
100,
75
],
"VideoLatency": [],
"CpuUsed": [
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02,
35.02
],
"MemUsed": [
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25,
71.25
],
"TimeOffset": [
0,
2,
4,
6,
8,
10,
12,
14,
16,
18,
20,
22,
24,
26,
28,
30,
32,
34,
36,
38,
40,
42,
44,
46,
48,
50,
52,
54,
56,
58
],
"ProjectId": "bhmerlz6dysrptnl",
"DeviceId": "dev_0240702040008",
"Ver": "2.4",
"SdkMode": "server2",
"DecodeCost": [],
"RenderCost": [],
"K100": [],
"K150": [],
"NACK": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"BitRateEstimate": [
0,
975,
1214,
958,
1354,
1970,
1987,
1756,
2000,
2000,
2000,
2000,
1883,
2000,
1982,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000,
2000
],
"Width": 1280,
"Height": 720,
"EncodeCost": [
0,
0,
9,
12,
22,
26,
24,
28,
12,
8,
13,
8,
10,
13,
22,
10,
16,
8,
10,
7,
8,
11,
8,
8,
19,
9,
8,
8,
7,
12
],
"CaptureCost": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"ConfigWidth": 1920,
"ConfigHeight": 1536,
"FrameDelta": [
0,
48,
50,
49,
50,
50,
50,
50,
50,
50,
51,
50,
51,
50,
51,
50,
50,
50,
50,
50,
50,
50,
50,
50,
51,
51,
51,
50,
50,
51
],
"MaxFrameDelta": [
0,
59,
60,
62,
58,
64,
67,
61,
62,
70,
64,
71,
70,
68,
79,
73,
67,
73,
76,
77,
67,
84,
65,
67,
73,
81,
68,
68,
73,
87
],
"TotalBitrateEstimate": [
0,
2635,
3407,
2588,
3871,
5902,
5958,
5196,
6266,
6322,
6411,
6043,
5617,
6785,
5941,
7000,
6000,
7000,
7200,
7200,
7200,
7200,
6098,
6124,
6146,
6173,
6203,
6239,
6281,
6330
],
"Lag100Duration": [],
"Lag150Duration": [],
"MultiMode": 1,
"MultiNet": [
{
"NetId": 0,
"NetIp": "192.168.11.2",
"Rtt": [
0,
0,
62,
65,
64,
66,
66,
68,
69,
67,
64,
63,
61,
66,
68,
62,
61,
63,
71,
66,
63,
63,
63,
62,
66,
65,
66,
67,
63,
63
],
"Lost": [
0,
0,
1,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"SendBps": [
0,
77,
36,
112,
416,
1212,
579,
658,
666,
791,
33,
283,
570,
582,
704,
655,
670,
718,
704,
702,
688,
726,
1472,
761,
696,
617,
659,
750,
706,
706
],
"RecvBps": [
0,
53,
27,
28,
28,
54,
27,
27,
26,
49,
23,
23,
23,
23,
23,
23,
23,
22,
23,
23,
22,
24,
44,
23,
23,
22,
23,
23,
23,
23
]
},
{
"NetId": 1,
"NetIp": "192.168.10.2",
"Rtt": [
0,
94,
141,
262,
118,
113,
149,
132,
116,
111,
113,
265,
118,
109,
104,
106,
107,
106,
113,
107,
107,
109,
118,
115,
110,
116,
107,
109,
113,
113
],
"Lost": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"SendBps": [
0,
82,
727,
317,
38,
75,
36,
36,
36,
752,
669,
379,
33,
34,
32,
32,
30,
32,
32,
32,
30,
32,
64,
32,
30,
32,
32,
30,
32,
32
],
"RecvBps": [
0,
75,
96,
38,
39,
79,
36,
38,
36,
74,
34,
32,
34,
35,
34,
34,
35,
33,
33,
35,
33,
35,
69,
34,
33,
34,
34,
33,
35,
35
]
}
]
},
{
"DeviceType": "remote",
"StartTime": 1731399572,
"EndTime": 1731399664,
"SessionId": "c52cc0cc-3663-467b-a6d1-2f01d20ad7ae-1",
"Rate": [
0,
263,
257,
128,
250,
186,
404,
433,
583,
374,
542,
346,
372,
451,
456,
469,
572,
469,
481,
522,
549,
582,
522,
506,
0,
716,
706,
687,
731,
0,
637,
597,
0,
745,
0,
4241,
453,
469,
0,
7812
],
"Fps": [
0,
15,
20,
19,
19,
18,
19,
18,
19,
19,
19,
18,
18,
18,
19,
19,
19,
19,
19,
19,
18,
19,
18,
19,
0,
19,
20,
19,
19,
0,
19,
19,
0,
22,
0,
141,
19,
19,
0,
267
],
"Lost": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"NetworkLatency": [
-1,
5,
5,
5,
7,
7,
5,
5,
5,
5,
5,
5,
5,
6,
5,
5,
5,
6,
5,
5,
5,
6,
7,
5,
-1,
6,
6,
7,
11,
-1,
9,
6,
-1,
5,
-1,
5,
5,
5,
-1,
5
],
"VideoLatency": [
0,
0,
0,
81,
55,
53,
56,
59,
99,
102,
48,
62,
58,
64,
66,
69,
58,
64,
54,
64,
77,
78,
83,
56,
61,
69,
71,
67,
60,
0,
66,
60,
0,
63,
0,
0,
0,
61,
0,
63
],
"CpuUsed": [
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.39,
15.4,
15.4,
15.4,
15.4,
15.4,
15.4,
15.4,
15.4
],
"MemUsed": [
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.08,
44.17,
44.17,
44.17,
44.01,
44.01,
44.04,
44.04,
44.04,
44.17,
44.17,
44.27,
44.27,
44.27,
44.27,
44.64,
44.64
],
"TimeOffset": [
0,
2,
4,
6,
8,
10,
12,
14,
16,
18,
20,
22,
24,
26,
28,
30,
32,
34,
36,
38,
40,
42,
44,
46,
49,
51,
53,
59,
61,
65,
67,
69,
73,
75,
79,
81,
83,
85,
90,
92
],
"ProjectId": "bhmerlz6dysrptnl",
"DeviceId": "driver_456",
"Ver": "2.4",
"SdkMode": "server2",
"DecodeCost": [
0,
1,
2,
1,
3,
1,
2,
2,
3,
2,
2,
3,
3,
1,
2,
2,
2,
3,
2,
2,
3,
3,
3,
3,
2,
2,
2,
7,
9,
2,
2,
2,
2,
3,
2,
2,
2,
2,
2,
4
],
"RenderCost": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"K100": [
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
0,
0,
0,
0.32,
0.32,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0.09,
0.09
],
"K150": [
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0.57,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"NACK": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
23,
23,
23,
23,
0,
0,
0,
0,
0,
0,
0,
0,
0,
1,
0,
0,
0,
0,
0,
0
],
"BitRateEstimate": [],
"Width": 1280,
"Height": 720,
"EncodeCost": [],
"CaptureCost": [],
"ConfigWidth": 0,
"ConfigHeight": 0,
"FrameDelta": [
19,
63,
49,
50,
49,
50,
50,
51,
51,
50,
48,
51,
50,
51,
50,
50,
50,
49,
49,
50,
50,
50,
51,
49,
45,
50,
50,
11,
50,
4,
17,
50,
4,
15,
4,
8,
51,
49,
4,
5
],
"MaxFrameDelta": [
49,
359,
93,
75,
70,
83,
99,
95,
102,
98,
109,
78,
81,
93,
88,
84,
99,
106,
116,
95,
195,
80,
98,
153,
83,
98,
95,
89,
108,
18,
96,
74,
18,
83,
19,
75,
95,
79,
15,
103
],
"TotalBitrateEstimate": [],
"Lag100Duration": [
0,
372,
0,
0,
0,
0,
0,
0,
2,
0,
11,
0,
0,
0,
0,
0,
0,
6,
16,
0,
95,
0,
0,
53,
0,
0,
0,
0,
13,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
3
],
"Lag150Duration": [
0,
219,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
45,
0,
0,
3,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"MultiMode": 0,
"MultiNet": []
}
]
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation | 操作失败。 |
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
| MissingParameter | 缺少参数错误。 |
| OperationDenied | 操作被拒绝。 |
