GetAVPlayerAttribute

返回针对容器字段中音频、视频或图像文件的指定属性的设置。

格式 

GetAVPlayerAttribute (属性名称)

参数 

属性名称 - 支持的属性的名称(如下所示)。

返回的数据类型 

文本、数字

原始版本 

14.0

说明 

此函数在 FileMaker Go 中使用。如果在播放或暂停媒体文件时调用此函数,则返回表示文件当前回放状态的值。如果在未播放媒体时调用此函数,则返回最近播放的媒体文件的状态。如果在从未播放过任何媒体文件的情况下调用此函数,则返回空字符串或“0”。

属性

属性

返回

返回的数据类型

all

所有属性及其值。

文本

sourceType

用于音频和视频文件的源类型:
0 (无)
1 (URL)
2(字段)
3(布局对象)
4(活动对象)

数字

source

URL、字段名或布局对象名。如果 sourceType 为 4(活动对象),那么 source 会返回空字符串。

文本

playbackState

一个数字,表示媒体回放的状态:
0(已停止)
1(正在播放)
2(已暂停)

数字

presentation

用于显示媒体的方法:
0(嵌入式)
1(全屏)
2(仅全屏)
3(仅音频)
4(嵌入式)

数字

position

媒体中当前正在播放的位置(以秒为单位)。

数字

startOffset

回放的开始位置(以秒为单位)。

数字

endOffset

回放的结束位置(以秒为单位);如果播放到媒体结束,则返回“0”。

数字

duration

音频或视频文件将播放的时间长度(以秒为单位)。

数字

triggerEvent

指示激活最后一个 OnObjectAVPlayerChange 或 OnFileAVPlayerChange 脚本触发器的原因:
0(内部)
1(脚本)
2(远程)

数字

triggerEventDetail

提供有关激活最后一个 OnObjectAVPlayerChange 或 OnFileAVPlayerChange 脚本触发器的事件的信息:
0(未知)
1(远程播放媒体)
2(远程暂停)
3(远程切换播放暂停)
4(远程播放下一个)
5(远程播放上一个)
6(远程搜寻)
7(远程停止)
8(脚本播放媒体)
9(脚本更改演示)
10(脚本切换播放暂停)
11(脚本停止)
12(脚本更改设置)
13(内部切换播放暂停)
14(内部更改演示)
15(内部搜寻)
16(内部停止)
17(内部更改缩放)
18(内部更改卷)
19(内部更改 PIP)
20(内部更改外部回放)

数字

sequence

指示接下来播放哪个媒体文件:
0(无)
-1(转至上一个)
+1(转至下一个)

数字

结果

如果回放成功结束,则返回“0”;如果回放因错误而结束,则返回“1”。

数字

hideControls

如果回放控件被隐藏,则返回“1”(是) ;否则返回“0”(否)。

数字

disableInteraction

如果用户无法与回放交互,则返回“1”(是) ;否则返回“0”(否)。

数字

disableExternalControls

如果在播放或暂停媒体时,锁定屏幕上或控制面板上的 iOS 或 iPadOS 回放控件被禁用,则返回“1”(是) ;否则返回“0”(否)。

数字

pauseInBackground

0,FileMaker Go 移至后台时,视频被暂停(“画中画”除外)、音频继续播放。
1,FileMaker Go 移至后台时,音频和视频均暂停。
2,FileMaker Go 移至后台时,音频和视频均继续播放。

数字

zoom

指示视频的显示方式:
0(调整),保留宽高比,视频缩放至适合回放区域。
1(填充),保留宽高比,视频缩放至填充到回放区域内。
2(拉伸),视频拉伸至填充到回放区域内,但不保留宽高比。
3(仅限调整),不允许用户更改缩放设置来填充或拉伸。
4(仅限填充),不允许用户更改缩放设置来填充或拉伸。
5(仅限拉伸),不允许用户更改缩放设置来调整或填充。

数字

volume

指示音频的音量水平。

数字

pictureInPicture

指定视频是否显示为“画中画”:
0(不适用)
1(非活动)
2(活动)

数字

externalPlayback

指定视频是否在外部设备上播放,例如通过 AirPlay 在 Apple TV 上播放:
0(不适用)
1(非活动)
2(活动)

数字

imageSourceType

用于图像的源类型:
0(无)
1 (URL)
2(字段)
3(布局对象)
4(活动对象)

数字

imageSource

图像的 URL、字段名或布局对象名。

文本

imageDuration

图像应显示的时间长度(以秒为单位)。

数字

示例 1 

停止播放媒体文件(如果它当前正在播放)。

复制
If [GetAVPlayerAttribute("playbackState") = 1]
    AVPlayer 设置回放状态 [已停止]
End If

示例 2 

检查媒体文件的持续时间,如果时间超过 30 分钟则显示消息。

复制
If [GetAVPlayerAttribute("duration") > 1800]
    显示自定义对话框 ["超过最长持续时间"; "当前视频超过 30 分钟。"]
Else
    AVPlayer 播放 [字段:库::视频]
End If