NovaCloud-EN
  1. Scheduled Control
NovaCloud-EN
  • API Access Guide
  • Common HTTP Status Codes
  • VNNOX
    • Player
      • Player Management
        • Obtain player list
      • Obtaining Player Status
        • Obtaining Basic Player Information
        • Obtaining Player Configuration Status
    • Solutions
      • Emergency Insertion
        • Single-Page Emergency Insertion Solutions
        • Canceling Emergency Insertion Solutions
      • Program widget examples
        • Hand-drawn clock widget
        • Weather widget
        • Environmental Monitoring widget
      • Common Solutions
      • Offline Export
      • Over-specification Detection Switching
      • Program Over-specification Detection
    • Real-Time Control
      • NTP Time Synchronization
      • Synchronous playback
      • Brightness Adjustment
      • Screenshots
      • Volume Adjustment
      • Video Source Switching
      • Screen Status
      • Restart Players
      • Screen Power
    • Scheduled Control
      • Scheduled Screen Status
        POST
      • Scheduled Restart Players
        POST
      • Scheduled Volume Adjustment
        POST
      • Scheduled Brightness Adjustment
        POST
      • Scheduled Video Source Switching
        POST
    • Logs
      • Play Logs
        • Batch Searching for Play Log Overviews
        • Batch Searching for Play Log Details
        • Searching for the Play Log Detail of a Single Player
        • Searching for the Play Log Overview of a Single Player
      • Obtaining Control Command Execution Logs
    • Notifications
      • Video Source Change Notifications
      • Solution Change Notifications
  • VNNOXCare
    • Notes
    • Device Status Monitoring
      • Receiving Card
        • Topology Information
        • Basic Information
        • Monitoring Information
        • Alarm Information
      • Screen
        • Screen list
        • Screen detail
        • Monitoring Information
      • Master Controller
        • Basic Information
        • Alarm Information
        • Operating Parameters Information
      • Smart Module
        • Monitoring Information
        • Alarm Infomation
      • Input Source
        • Monitor Infomation
      • Module/Cabinet
        • Monitoring Information
      • Monitoring Card
        • Monitoring Information
    • Brightness Log
      • Brightness History
  • Others
    • Third-Party System Authorization
      • Obtaining User List
      • Obtaining Login URL
  1. Scheduled Control

Scheduled Video Source Switching

Testing
US
US
POST
/v2/player/scheduled-control/video-source
TIP
1.
This interface provides scheduled video source switching, with batch support for up to 100 players.
2.
Sub-accounts have permission to manage only players within their assigned workgroup and any nested sub-workgroups.
3.
Advanced interface.

Request

Header Params
AppKey
string 
required
Access key
Default:
{{AppKey}}
Nonce
string 
required
Random string (8-64 characters, only numbers or letters)
CurTime
string 
required
The current UTC timestamp
CheckSum
string 
required
Request signature
Body Params application/json
playerIds
array[string]
required
Array of player IDs to process. Maximum batch size: 100 players.
schedules
array [object {5}] 
required
A collection of time scheduling plans. If an empty array is passed, all set time schedules will be cleared.
startDate
string 
required
The start date of the scheduled plan, in the format of YYYY-MM-DD (e.g. 2023-01-01)
endDate
string 
required
The end date of the scheduled plan, in the format of YYYY-MM-DD (e.g. 2023-01-01)
weekDays
array[integer]
optional
Scheduled week configuration, effective elements range 0-6: 0-Sunday, 1-Monday, 2-Tuesday, 3-Wednesday, 4-Thursday, 5-Friday, 6-Saturday. If any element exists, the schedule takes effect on the day, and the default or empty collection indicates that it is executed every day within the validity period. And if the parameter is not provided, it indicates that the plan will executed daily.
execTime
string 
required
The scheduled execution time is in 24-hour HH:MM:SS format (for example, 21:00:00). Note: The player triggers the execution plan based on the player local time.
source
integer 
required
Video source type, 0-internal, 1-external.
Example
{
  "playerIds": [
    "f14cb76a01320c2c4fba81bc0cb4b3af",
    "85dacf69cb2c57bb508a6d126d189383",
    "8921b722dc7f6b1b1e20dafcf553a554",
    "6c09ee7576f9ec298be5e20e21569adb",
    "f4db107e317e841585bbd7a67573885e",
    "9b9ce094e2b9d70576460bd4c475748d"
  ],
  "schedules": [
    {
      "startDate": "2025-01-01",
      "endDate": "2025-12-31",
      "execTime": "08:30:00",
      "weekDays": [
        0,
        6
      ],
      "source": 0
    },
    {
      "startDate": "2025-01-01",
      "endDate": "2025-12-31",
      "weekDays": [
        1,
        2,
        3,
        4,
        5
      ],
      "execTime": "08:30:00",
      "source": 1
    }
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open-us.vnnox.com/v2/player/scheduled-control/video-source' \
--header 'AppKey;' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "playerIds": [
        "f14cb76a01320c2c4fba81bc0cb4b3af",
        "85dacf69cb2c57bb508a6d126d189383",
        "8921b722dc7f6b1b1e20dafcf553a554",
        "6c09ee7576f9ec298be5e20e21569adb",
        "f4db107e317e841585bbd7a67573885e",
        "9b9ce094e2b9d70576460bd4c475748d"
    ],
    "schedules": [
        {
            "startDate": "2025-01-01",
            "endDate": "2025-12-31",
            "execTime": "08:30:00",
            "weekDays": [
                0,
                6
            ],
            "source": 0
        },
        {
            "startDate": "2025-01-01",
            "endDate": "2025-12-31",
            "weekDays": [
                1,
                2,
                3,
                4,
                5
            ],
            "execTime": "08:30:00",
            "source": 1
        }
    ]
}'

Responses

🟢200Success
application/json
Body
success
array[string]
required
fail
array[string]
required
Example
{
  "success": [
    "8f29699ae6db7c584b60fa345c984a0e",
    "f14cb76a01320c2c4fba81bc0cb4b3af",
    "85dacf69cb2c57bb508a6d126d189383",
    "8921b722dc7f6b1b1e20dafcf553a554",
    "6c09ee7576f9ec298be5e20e21569adb",
    "f4db107e317e841585bbd7a67573885e",
    "9b9ce094e2b9d70576460bd4c475748d"
  ],
  "fail": []
}
Modified at 2025-04-18 07:13:46
Previous
Scheduled Brightness Adjustment
Next
Batch Searching for Play Log Overviews
Built with