使应用用户能够从其设备录制声音的控件。
Description
使用 麦克风 控件通过设备的麦克风捕获音频。 设备必须具有麦克风，用户必须授权应用使用麦克风。
最近录制的音频剪辑可通过 Audio 属性获得。 使用此属性，录制的音频可以是：
- 使用音频控件播放。 使用 音频 控件收听录制。 有关详细信息，请参阅 示例。
- 暂时放入变量或集合中。 使用 Set 或 Collect 函数将音频剪辑存储在变量或集合中。 请谨慎处理集合中的多个音频剪辑，同时具有设备的有限内存。 使用 SaveData 和 LoadData 函数将音频剪辑移动到设备上的本地存储，以及用于 脱机方案。
- 存储在数据库中。 使用 Patch 函数将音频剪辑存储在数据库中。
- 以 base64 编码文本字符串的形式传输。 使用 JSON 函数对音频剪辑进行 base64 编码。
录制的音频的格式：
- 适用于 Android 的 3gp 格式。
- 适用于 iOS 的 AAC 格式。
- Web 浏览器的 OGG 格式。
捕获的媒体由文本字符串 URI 引用。 有关详细信息，请阅读 数据类型文档。
注释
麦克风控件仅在基于 Chromium、Chrome 和 Firefox 浏览器的 Microsoft Edge 上受支持;和 Android 和 iOS 设备。 所有其他浏览器和平台将显示一条警告，指出应用的某些功能不起作用。
局限性
麦克风控件具有以下限制：
- Power Apps Mobile 在各种类型的设备上运行，其中一些设备具有特定于该平台的限制：
- 你可以在除 iPhone 设备以外的所有平台上同时播放多个视频控件中的 视频 。
- 你可以在除 Web 播放器以外的所有平台上同时录制具有多个 麦克风 控件的音频。
键属性
音频 – 当用户使用设备的麦克风录制时捕获的音频剪辑。
麦克风 – 具有多个麦克风的设备上的麦克风的数字 ID。
OnStop – 当用户停止使用麦克风控件录制时要执行的作。
其他属性
AccessibleLabel – 屏幕阅读器标签。 应描述麦克风的用途。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
颜色 – 控件中的文本颜色。
DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。
DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled，则控件边框的颜色。
DisabledColor – 控件中的文本颜色（如果控件的 DisplayMode 属性设置为 Disabled）。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时的背景色。
填充 – 控件的背景色。
FocusedBorderColor – 当控件聚焦时控件边框的颜色。
FocusedBorderThickness – 当控件聚焦时控件边框的粗细。
高度 – 控件的上边缘和下边缘之间的距离。
HoverBorderColor – 当用户在该控件上保留鼠标指针时控件边框的颜色。
HoverColor – 当用户将鼠标指针放在控件上时，控件中文本的颜色。
HoverFill – 当用户将鼠标指针放在控件上时，控件的背景色。
图像 – 图像、音频或麦克风控件中显示的图像的名称。
ImagePosition – 图像在屏幕或控件中的位置（填充、 调整、 拉伸、 平铺或 居中），如果图像的大小与图像大小不同。
OnSelect – 当用户选择控件时要执行的作。
OnStart – 当用户开始使用麦克风控件录制时要执行的作。
PressedBorderColor – 当用户选择该控件时控件边框的颜色。
PressedColor – 当用户选择该控件时控件中的文本颜色。
PressedFill – 当用户选择该控件时控件的背景色。
重置 – 控件是否还原为其默认值。
TabIndex – 键盘导航顺序与其他控件相比。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件的左边缘与其父容器或屏幕的左边缘之间的距离。
Y – 控件的上边缘与父容器或屏幕的上边缘之间的距离。
例子
简单的直接播放
在此示例中，我们将直接将 麦克风 控件与 音频 控件连接，以便立即播放：
向应用添加麦克风控件。
授权应用在出现提示时使用设备的麦克风。
向应用添加 音频 控件。
将 音频 控件的 Media 属性设置为公式：
Microphone1.Audio注释
根据需要替换麦克风控件名称 Microphone1 。
预览应用。
选择 麦克风 控件开始录制。
朗声录制音频。
再次选择 麦克风 控件以结束录制。
选择 音频 控件以收听录制。
向库控件添加声音
在此示例中，我们将创建存储在集合中的音频剪辑库，该库可以单独选择用于播放：
添加麦克风控件。
使用 Collect 函数将其 OnStop 属性设置为此公式：
Collect( MySounds, MyMic.Audio )添加 库 控件，将其移动到 MyMic 下方。
将库的 Items 属性设置为以下公式：
MySounds在 自定义库 控件的模板中，添加 音频 控件。
将音频控件的 Media 属性设置为以下公式：
ThisItem.Url按 F5 预览应用。
选择 MyMic 开始录制，然后再次选择它以停止录制。
在 库 控件中，选择 音频 控件中的播放按钮以播放录制。
根据需要添加任意数量的录制内容，然后按 Esc 键返回到默认工作区。
（可选）在 库 控件的模板中，添加 按钮 控件。
将其 OnSelect 属性设置为公式：
Remove( MySounds, ThisItem )按 F5，然后通过选择相应的 按钮 控件删除录制内容。
使用 SaveData 函数在本地保存录制内容或 Patch 函数更新数据源。
辅助功能指南
按钮的相同准则适用，因为麦克风只是一个专用按钮。 此外，请考虑：
音频替代项
请考虑为有语音障碍或没有麦克风的用户添加替代形式的输入。 例如， 允许用户输入文本的文本 。
颜色对比度
屏幕阅读器支持
- AccessibleLabel 必须存在。