AVPlayer Set Options

Changes the settings for a media file that is playing or is paused.

Options 

  • Presentation changes the setting for displaying the media.
    • Start Full Screen starts playing the media in full screen but allows changing the presentation to embedded.
    • Full Screen Only plays the media in full screen.
    • Start Embedded starts playing the media as embedded but allows changing the presentation to full screen.
    • Embedded Only plays the media as embedded and doesn't allow changing the presentation to full screen.
    • Audio Only plays only the audio.
  • Disable Interaction changes the setting for enabling or disabling user interaction with the playback. If this option is set to Yes, you cannot use the playback controls or gestures to interact with the media.
    • Yes disables user interaction with the playback.
    • No enables user interaction with the playback.
  • Hide Controls changes the setting for showing or hiding the playback controls while the media plays. If you hide the playback controls but enable interaction, you can use gestures instead of playback controls.
    • Yes hides the playback controls.
    • No shows the playback controls.
  • Disable External Controls enables or disables the iOS or iPadOS playback controls on the lock screen or Control Center when the media is playing or is paused.
    • Yes disables the playback controls.
    • No enables the playback controls.
  • Pause in Background changes the setting for playing the audio and video when FileMaker Go moves to the background. If this option is not set and FileMaker Go moves to the background, the audio continues to play, but the video is paused.
    • Yes pauses the audio and video.
    • No continues playing the audio and video.
  • Position specifies how many seconds from the beginning of the media to move the current playback.
  • Start Offset specifies the beginning of the playback range in seconds from the beginning of the media. The media can be played only within the playback range. For example, if you set this option to 30, the user cannot rewind into or play the first 30 seconds of the media. The default value for this option is 0, which allows the media to start from the beginning.
  • End Offset specifies the end of the playback range in seconds from the beginning of the media. The media can be played only within the playback range. For example, if you set this option to 100, the user cannot fast forward or play past 100 seconds of the media. The default value for this option is 0, which allows the media to play to the end.
  • Zoom specifies how to display the video:
    • Fit preserves the aspect ratio and scales the video to fit within the playback area.
    • Fill preserves the aspect ratio and scales the video to fill the playback area.
    • Stretch stretches the video to fill the playback area, but it doesn't preserve the aspect ratio.
    • Fit Only doesn't allow users to change the zoom setting to Fill or Stretch.
    • Fill Only doesn't allow users to change the zoom setting to Fit or Stretch.
    • Stretch Only doesn't allow users to change the zoom setting to Fit or Fill.
  • Volume specifies a value between 0.0 and 1.0 as the volume level for the audio.
  • Sequence specifies which media file should play next.
    • None plays no additional media.
    • Next plays the next media.
    • Previous plays the previous media.

Compatibility 

Product Supported
FileMaker Pro No
FileMaker Go Yes
FileMaker WebDirect No
FileMaker Server No
FileMaker Cloud No
FileMaker Data API No
Custom Web Publishing No

Originated in version 

14.0

Description 

Use this script step to change the settings for audio, video, or image files when the file is playing or is paused.

Example 1 

Changes the setting of a video that is currently playing to start the playback 50 seconds from the beginning of the file. The video is stretched to fill the playback area without preserving the aspect ratio.

Copy
AVPlayer Set Options [Position: 50; Zoom: Stretch]

Example 2 

Enables user interaction with the playback after the video has played for 30 seconds.

Copy
AVPlayer Play [Object Name: "Container"; Disable Interaction: Yes]
Pause/Resume Script [Duration (seconds): 30]
AVPlayer Set Options [Disable Interaction: No]

Example 3 

Pauses the audio file that is playing if FileMaker Go moves to the background.

Copy
AVPlayer Set Options [Pause in Background: Yes]