Example

====== Set Playback Priority ======

^ by: | Sebastian Beutel, February 2022 |
^ published: | here |
^ description: | set a playback's priority |
^ remarks: | idea: https://www.facebook.com/groups/Avolites/posts/2423569344441952?comment_id=2423573241108229&reply_comment_id=2423589471106606 |

{{tag>playback priority}}

==== functions ====
  * [[:macros:function:Playbacks.Select.EditHandle]]
  * [[:macros:function:ActionScript.SetProperty.Enum]]

==== affected properties ====
  * [[:macros:property:HandleOptions.Playbacks.Priority]]
 
===== Code =====
<code xml PbPriority.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros">
 <macro name="PB 100 VeryHighPriority" id="Wiki.Macros.PB100.VeryHighPriority">
    <sequence>
      <step>Playbacks.Select.EditHandle("playbackHandleUN=100")</step>
      <step>ActionScript.SetProperty.Enum("HandleOptions.Playbacks.Priority","MaximumPriority")</step>
    </sequence>
  </macro>
  <macro name="PB 100 HighPriority" id="Wiki.Macros.PB100.HighPriority">
    <sequence>
      <step>Playbacks.Select.EditHandle("playbackHandleUN=100")</step>
      <step>ActionScript.SetProperty.Enum("HandleOptions.Playbacks.Priority","HighPriority")</step>
    </sequence>
  </macro>
  <macro name="PB 100 NormalPriority" id="Wiki.Macros.PB100.NormalPriority">
    <sequence>
      <step>Playbacks.Select.EditHandle("playbackHandleUN=100")</step>
      <step>ActionScript.SetProperty.Enum("HandleOptions.Playbacks.Priority","MediumPriority")</step>
    </sequence>
  </macro>
</avolites.macros>
</code>


===== Explanation =====

This explains the functional steps within the sequence. For all the other XML details please refer to [[:macros:formats_and_syntax#xml_format|Formats and syntax]]

  * ''Playbacks.Select.EditHandle'' selects a specific handle (here: by its [[macros:identifier:usernumber|]])
  * ''ActionScript.SetProperty.Enum("HandleOptions.Playbacks.Priority",...)'' sets the selected playback's priority

===== How to use it =====

  - [[:macros:deploying|make this macro available]]
  - give the playback which you want to treat userNumber 100
  - fire the macro when needed


~~DISCUSSION~~