User Rights
General
Request | Required right name |
|---|---|
Reload service settings | TurboPlayerService.ReloadSettings |
Data models
Request | Required right name |
|---|---|
Create local data model (see TurboPlayer Service SDK data model for details) | TurboPlayerService.CreateLocalDataModel |
Elements
Request | Required right name |
|---|---|
Start an element | TurboPlayerService.ElementStart |
Stop an element | TurboPlayerService.ElementStop |
Prepares an item, a.k.a. loads an item into a specific channel to be started very fast. The channel will be occupied then, of course. | TurboPlayerService.ElementPrepare |
Selects one of the element to be played with the next start command. | TurboPlayerService.ElementSelectNextPlay |
Selects one of the elements as the current cursor item | TurboPlayerService.ElementSelectCursor |
Selects one of the element for prelistening | TurboPlayerService.ElementSelectPrelisten |
Inserts an element (unknown to the engine) into the prelisten list and activates the prelisten state for an engine/MultiPlayer prelisten | TurboPlayerService.ElementAddPrelisten |
Inserts an element (unknown to the TurboPlayer) into the prelisten list and activates the prelisten state | TurboPlayerService.ElementChangePrelistenState |
TurboPlayer Macros
To allow TurboPlayer Service users to execute macros (EventsOut) or commands (i.e TP_Start), specific action rights must be assigned through Digas configuration of Users and Groups.
1. General Permission Requirement
Before any macro or command can be executed, a user must have the general execution right:
Request | Required right name |
|---|---|
Allow execution of TurboPlayer Macros | TurboPlayerService.ExecuteMacro |
Important: Without this right, no macros or commands can be executed, even if individual macro rights are granted.
2. Permissions for specific Macros or Commands
To execute an individual macro or command, users must also be granted the corresponding specific execution right, following this format:
Request | Required right name |
|---|---|
Allow execution of specific TurboPlayer Macro Or Command | TurboPlayerService.Execute.<MacroOrCommand> |
Example:
To execute the command TP_Start, the user must have both of the following rights:
Request | Required right name |
|---|---|
Allow execution of the command TP_Start | TurboPlayerService.ExecuteMacro TurboPlayerService.Execute.TP_Start |
3. Granting Access to All Macros and Commands
If a user or group should be able to execute all available macros and commands, assign these rights:
Request | Required right name |
|---|---|
Allow execution of all macros and commands in one step | TurboPlayerService.ExecuteMacro |
This combination grants unrestricted execution rights across all macros and commands.
4. Revoking the right to execute any macros or commands
Revoke the following action right to prevent users from running any macros or commands.
TurboPlayerService.ExecuteMacro
5. Managing Rights Using Digas Users and Groups
It is recommended to manage permissions through Digas groups for easier administration and scalability.
Best practice example to allow execution of commands only:
Create a group called Commands.
Assign the following rights to the group:
TurboPlayerService.ExecuteMacro
TurboPlayerService.Execute.TP_Start
TurboPlayerService.Execute.TP_Stop
… Other TurboPlayer built-in commands
Add users to the Commands group. Each user automatically inherits all rights assigned to the group.
TurboPlayer modes
Request | Required right name |
|---|---|
Activate or deactivate TurboPlayer Kernel mode | TurboPlayerService.SetKernelMode |
Change TurboPlayer modes for the specified rundown list type | TurboPlayerService.SetRundownListMode |
Load objects
Request | Required right name |
|---|---|
Load jingle group | TurboPlayerService.LoadJingleGroup |
Load start show to play by disabled FreeShowList mode | TurboPlayerService.LoadShow |
Load shows to play by enabled FreeShowList mode | TurboPlayerService.LoadFreeShowList |
Load node into stack | TurboPlayerService.LoadNodeIntoStack |
Other rights
Request | Required right name |
|---|---|
Perform changes in rundown list (insert, update, delete) | TurboPlayerService.ChangeRundownList |
Writes real times for the next element in rundown, though it is not playing | TurboPlayerService.AdjustTimes |
Performs a de-link for a remote show or track | TurboPlayerService.Delink |