NovaCloud-CN

获取播放器配置状态

POST

/v2/player/current/running-status

提示

通过此接口异步获取播放器的当前音量、亮度、视频源、时区/时间等状态信息。

子账号只能获取到本工作组以及子工作组的数据。

高级接口。

请求参数

Header 参数

AppKey

string

接入键

必需

默认值:

Nonce

string

必需

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

CurTime

string

必需

当前 UTC 时间戳

CheckSum

string

请求签名

必需

Body 参数application/json

playerIds

array[string]

必需

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

commands

array[string]

必需

需要获取的命令集合。volumeValue - 当前音量值；brightnessValue - 当前亮度值；videoSourceValue - 当前视频源；timeValue - 当前时区和时间；screenPowerStatus - 当前屏幕状态(new)；syncPlayStatus - 当前同步播放状态(new)；powerStatus - 当前电源多功能卡状态(new)

noticeUrl

string

必需

结果通知接口。客户接口必须返回 “ok” 字符串，否则系统会重试一次。

示例

{
    "playerIds": [
        "8208967d40e9980bab6d12367dc88e0b"
    ],
    "commands": [
        "volumeValue",
        "brightnessValue",
        "videoSourceValue",
        "timeValue"
    ],
    "noticeUrl": "http://www.abc.com/notice"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-cn.vnnox.com/v2/player/current/running-status' \
--header 'AppKey;' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "playerIds": [
        "8208967d40e9980bab6d12367dc88e0b"
    ],
    "commands": [
        "volumeValue",
        "brightnessValue",
        "videoSourceValue",
        "timeValue"
    ],
    "noticeUrl": "http://www.abc.com/notice"
}'

返回响应

🟢200成功

application/json

Body

success

array[string]

必需

下发成功的播放器ID集合

fail

array[string]

必需

下发失败的播放器ID集合

示例

{
    "success": [
        "553cbfe2ff4ad2e0d6bd89bb2c4e85e2"
    ],
    "fail": []
}

🟢200获取当前时区和时间回调参数

🟢200获取当前视频源回调参数

🟢200获取当前当前音量值回调参数

🟢200获取当前当前亮度值回调参数

🟢200获取当前屏幕状态回调参数

🟢200获取当前同步播放状态回调参数

🟢200获取当前多功能卡电源状态回调参数

获取播放器运行状态

单页紧急插播节目