Adding video commands

Service providers can configure commands to request video streams, specific video clips, or photos from devices. These commands are sent to the device tracking unit. Before users can access these commands, service providers must first create command templates and then make them available in the FleetSpace interface via widgets.

Who can do it: Service provider
Where: Wialon Platform Studio

Command templates are reusable configurations that allow you to define a command once and apply it to many different devices. They are especially useful for managing mixed fleets, as a single template can contain the same command for different device models, simplifying configuration in the user interface.

To create a template with video commands, follow these steps:

1. Log in to Wialon Platform Studio.
2. Go to the Devices page.
3. Click the Command templates tab.
4. Click the Add button to create a new command template.
5. In the Name field, enter a descriptive name, such as “Request video clips”. You can also add an optional description.
6. Click Save.
7. On the Commands tab, select the device model and click the icon .
8. Select the command based on the required action. For example, depending on the specific device, the following commands can be available:
   • Request video: Downloads a video clip for a specified time and duration from a selected camera channel.
   • Playback video: Streams previously recorded video with playback controls.
   • Take photo: Requests a photo from a selected camera channel at the moment the command is executed.
9. Configure the default parameter values for the command. These values will be pre-filled when a user executes the command. You can leave them empty, which will require users to set them manually.
10. If you have different device models with video functionality, add a command for other devices to the same template repeating steps 7-9. One command template can contain similar commands for different types of devices, for example, the Request video commands with their own settings for Howen and Streamax devices.
11. Click Save to create the command template.

Who can do it: Service provider

Where: Wialon FleetSpace

You can configure the appropriate widgets in Wialon FleetSpace to make these commands accessible for users. You can add command widgets to either the device list or device details page.

1. Log in to Wialon Platform FleetSpace as the customer.
2. Navigate to the Devices page. If you want to add widgets in the device details, click on any device to open its details.
3. Click on the service provider name in the left bottom corner and enable the Editor mode toggle.
4. Ensure the required workspace is selected. If you need to create a new workspace, see the guide on setting up a workspace.
5. Click on the icon or in the top right corner of a device row. This opens the Device list entry: actions window.
6. Select the Execute command widget.
7. Select the previously configured command template and choose an icon for it.
8. Click on the icon .
9. Repeat steps 5-8 if you need to add more command widgets.
10. Click Save to apply the configuration.

Who can do it: Service provider

Where: Wialon Platform Studio

After configuring a command template, you must grant the customer user permission to access it.

1. Log in to Wialon Platform Studio.
2. Navigate to the Customers page from the main menu.
3. Select the required customer from the list.
4. Go to the Users tab within the customer’s details.
5. Click on the user’s row to open their details and go to the Permissions tab.
6. Click on the Devices page.
7. Ensure that the Send commands permission is selected.
8. Click Save to apply any changes to the user’s permissions.

After this setup, ensure the customer user has the necessary permissions to use the workspace where you’ve added the command widgets.

Also, remember to add a separate widget to enable users to view the results of the command execution. For example, if you add the Request video command, the user will need the Media widget to view downloaded videos. See Configuring video widgets for instructions.