在 YouTube 上播放音频文件、视频文件或视频的控件。
Description
音频控件从文件播放声音剪辑、麦克风控件的录制或视频文件中的音频曲目。
视频控件从文件或 YouTube 或任何外部源播放视频剪辑。 可以选择在指定时显示隐藏式字幕。
重要
不再支持 Azure 媒体服务上的视频。 有关详细信息，请参阅 服务停用。
局限性
音频和视频控件具有以下限制：
- Power Apps Mobile 在各种类型的设备上运行，其中一些设备具有特定于该平台的限制：
- 你可以在除 iPhone 设备以外的所有平台上同时播放多个视频控件中的 视频 。
- 你可以在除 Web 播放器以外的所有平台上同时录制具有多个 麦克风 控件的音频。
键属性
循环 – 音频或视频剪辑在播放完成后自动启动。
媒体 – 音频或视频控件播放的剪辑的标识符。
注释
- 对所有外部视频使用 HTTPS 以确保与新式浏览器兼容。
- 外部视频必须匿名访问（无需任何身份验证）。
ShowControls – 音频或视频播放器是否显示，例如播放按钮和音量滑块，以及笔控件显示，例如用于绘图、擦除和清除的图标。
其他属性
AccessibleLabel – 屏幕阅读器标签。 应该是视频或音频剪辑的标题。
AutoPause – 如果用户导航到其他屏幕，音频或视频剪辑是否会自动暂停。
自动启动 – 当用户导航到包含该控件的屏幕时，音频或视频控件是否自动开始播放剪辑。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
ClosedCaptionsUrl – 仅视频控件。 WebVTT 格式的隐藏式字幕文件的 URL。 视频和字幕 URL 必须是 HTTPS。 需要启用托管视频和字幕文件的服务器。
DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。
填充 – 控件的背景色。
FocusedBorderColor – 当控件聚焦时控件边框的颜色。
FocusedBorderThickness – 当控件聚焦时控件边框的粗细。
高度 – 控件的上边缘和下边缘之间的距离。
图像 – 图像、音频或麦克风控件中显示的图像的名称。
ImagePosition – 图像在屏幕或控件中的位置（填充、 调整、 拉伸、 平铺或 居中），如果图像的大小与图像大小不同。
OnEnd – 音频或视频剪辑完成播放时要执行的作。
OnPause – 当用户暂停音频或视频控件正在播放的剪辑时要执行的作。
OnStart – 当用户开始使用麦克风控件录制时要执行的作。
已暂停 – 如果媒体播放控件当前已暂停，则为 True ，否则为 false 。
重置 – 控件是否还原为其默认值。
开始 – 音频或视频剪辑是播放的。
StartTime – 剪辑开始播放音频或视频剪辑后的时间。
时间 – 媒体控件的当前位置。
TabIndex – 相对于其他控件的键盘导航顺序。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器（如果没有父容器，则为屏幕）左边缘之间的距离。
Y – 控件上边缘与其父容器（如果没有父容器，则为屏幕）上边缘之间的距离。
相关函数
例子
播放音频或视频文件
在 “文件 ”菜单上，单击或点击 “媒体”，单击或点击“ 视频 ”或“ 音频”，然后单击或点击“ 浏览”。
浏览到要使用的文件，单击或点击它，然后单击或点击“ 打开”。
按 Esc 返回到默认工作区，添加 音频 或 视频 控件，并将其 Media 属性设置为添加的文件。
不知道如何 添加和配置控件？
按 F5，然后通过单击或点击添加的控件的播放按钮来播放剪辑。
小窍门
将鼠标悬停在控件上时， 将显示视频 控件的播放按钮。
按 Esc 返回默认工作区。
播放 YouTube 视频
- 添加 视频 控件，并将其 媒体 属性设置为 YouTube 视频的 URL，括在双引号中。
- 按 F5，然后通过单击或点击 视频 控件的播放按钮播放剪辑。
- 按 Esc 返回默认工作区。
辅助功能指南
音频和视频替代项
- ShowControls 必须正确，以便用户可以按照自己的节奏收听或观看多媒体。 这也允许用户在视频播放器上切换隐藏式字幕和全屏模式。
- 必须为视频提供隐藏式字幕。
- 对于 YouTube 视频，请使用 YouTube 提供的创作工具添加字幕。
- 对于其他视频，请以 WebVTT 格式创建标题，将其上传，并将 ClosedCaptionsUrl 设置为 URL 位置。 有几个限制。 托管视频和字幕的服务器需要启用 CORS，并使用 HTTPS 协议为它们提供服务。
- 请考虑使用以下方法之一提供音频或视频脚本：
- 将文本置于 标签 中，并将其放置在多媒体播放器相邻的位置。 （可选）创建 一个按钮 来切换文本的显示。
- 将文本置于不同的屏幕中。 创建一个按钮，该 按钮 导航到屏幕，并将该按钮定位到多媒体播放器相邻。
- 如果说明简短，则可以将其放入 AccessibleLabel 中。
颜色对比度
在以下两者之间必须有足够的颜色对比度：
- FocusedBorderColor 和外部颜色
- 图像 和多媒体播放器控件（如果适用）
- 填充 和多媒体播放器控件（如果填充可见）
如果视频内容存在颜色对比度问题，请提供隐藏式字幕和/或脚本。
屏幕阅读器支持
- AccessibleLabel 必须存在。
键盘支持
- TabIndex 必须为零或更大，以便键盘用户可以导航到它。
- 焦点指示器必须清晰可见。 使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。
- 自动启动 应为 false，因为键盘用户可能很难快速停止播放。