NovaCloud-CN

电源控制

POST

/v2/player/real-time-control/power

提示

通过此接口对播放器的屏体电源进行控制（需要使用 LCT 或 VIPlex Express 将电源控制设备配置为“屏体电源”）。

子账号只能操作本工作组以及子工作组的数据。

高级接口。

请求参数

Header 参数

AppKey

string

接入键

必需

默认值:

Nonce

string

必需

随机字符串（8~64个字符，仅限数字或英文字母）

CurTime

string

必需

当前 UTC 时间戳

CheckSum

string

请求签名

必需

Body 参数application/json

playerIds

array[string]

必需

需要处理的播放器ID集合。最多支持100个播放器同时处理

option

integer

必需

控制屏体电源的状态。0 - 关闭，1 - 开启

示例

{
  "playerIds": [
    "4PBXun3mQoZGnKdLKoDtBA==",
    "4PBXun32QoZGnKdLKoDtBA=="
  ],
  "option": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-cn.vnnox.com/v2/player/real-time-control/power' \
--header 'AppKey;' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "playerIds":[
        "4PBXun3mQoZGnKdLKoDtBA==",
        "4PBXun32QoZGnKdLKoDtBA=="
    ],
    "option":1
}'

返回响应

🟢200成功

application/json

Body

success

array[string]

必需

下发成功的播放器ID集合

fail

array[string]

必需

下发失败的播放器ID集合

示例

{
  "success": [
    "4PBXun3mQoZGnKdLKoDtBA==",
    "4PBXun32QoZGnKdLKoDtBA=="
  ],
  "fail": [
    "4PBXun3mQoZGnKdLKoDtBA==",
    "4PBXun32QoZGnKdLKoDtBA=="
  ]
}

修改于 2024-08-07 01:35:02

播放器重启

定时屏幕状态