Power Apps 中的 麦克风 控件

允许应用用户从其设备录音的控件。

描述

使用麦克风控件可以使用设备的麦克风捕获音频。 该设备必须有麦克风,并且用户必须授权应用使用麦克风。

最近录制的音频剪辑可通过 音频 属性获得。 使用此属性,录制的音频可以:

  • 使用 音频 控件回放。 使用 音频 控件收听录音。 有关详细信息,请参阅示例
  • 临时放置在变量或集合中。 使用 SetCollect 函数将音频剪辑存储在变量或集合中。 在设备的内存有限的情况下,请谨慎使用集合中的多个音频剪辑。 使用 SaveDataLoadData 函数将音频剪辑移至设备上的本地存储,用于脱机场景
  • 存储在数据库中。 使用 Patch 函数将音频剪辑存储在数据库中。
  • 作为 base64 编码的文本字符串传输。 使用 JSON 函数对音频剪辑进行 base64 编码。

所录制音频的格式:

  • Android3gp 格式。
  • iOSAAC 格式。
  • Web 浏览器OGG 格式。

捕获的媒体由文本字符串 URI 引用。 有关详细信息,请阅读数据类型文档

备注

只有基于 Chromium、Chrome 和 Firefox 浏览器的 Microsoft Edge 和 Android 与 iOS 设备中才支持 麦克风 控件。 所有其他浏览器和平台将显示警告,提示应用的某些功能无法使用。

关键属性

音频 – 用户使用设备的麦克风录制时捕获的音频剪辑。

Mic – 有多个麦克风的设备上的麦克风的数字 ID。

OnStop – 当用户停止使用 麦克风 控件录制时要执行的操作。

其他属性

AccessibleLabel – 屏幕阅读器标签。 应描述麦克风的用途。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

Color – 控件中文本的颜色。

DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。

DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。

DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。

DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。

Fill – 控件的背景色。

FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。

FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。

Height – 控件上边缘和下边缘之间的距离。

HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。

HoverColor – 用户将鼠标指针停留在控件上时,该控件中的文本颜色。

HoverFill – 用户将鼠标指针停留在控件上时,该控件的背景色。

图像 – 在 图像、音频 或 麦克风 控件中显示的图像名称。

ImagePosition – 屏幕或控件大小与图像大小不同时,其中图像的位置(FillFitStretchTileCenter)。

OnSelect – 当用户选择控件时要执行的操作。

OnStart – 当用户开始使用 麦克风 控件录制时要执行的操作。

PressedBorderColor – 用户选择控件时,该控件边框的颜色。

PressedColor – 用户选择控件时,该控件中文本的颜色。

PressedFill – 用户选择控件时,该控件的背景色。

Reset – 控件是否还原为其默认值。

TabIndex – 相对于其他控件的键盘导航顺序。

Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。

Visible – 控件显示还是隐藏。

Width – 控件左边缘和右边缘之间的距离。

X – 控件左边缘与其父容器或屏幕左边缘之间的距离。

Y – 控件上边缘与其父容器或屏幕上边缘之间的距离。

示例

简单的直接播放

在此示例中,我们将直接将麦克风控件与音频控件连接以立即播放:

  1. 将一个麦克风控件添加到您的应用。

  2. 如果出现提示,授权应用使用设备的麦克风。

  3. 将一个音频控件添加到您的应用。

  4. 音频控件的 Media 属性设置为以下公式:

    Microphone1.Audio
    

    备注

    根据需要替换 麦克风 控件名称 Microphone1

  5. 预览应用。

  6. 选择麦克风控件开始录制。

  7. 讲话以录制音频。

  8. 再次选择麦克风控件结束录制。

  9. 选择音频控件收听录音。

将声音添加到 库 控件

在此示例中,我们将创建一个音频剪辑库,它存储在一个集合中,可以单独选择进行播放:

  1. 添加一个麦克风控件。

  2. 使用 Collect 函数将其 OnStop 属性设置为此公式:

    Collect( MySounds, MyMic.Audio )
    
  3. 添加一个 控件,将其移到 MyMic 下面。

  4. 将库的 Items 属性设置为以下公式:

    MySounds
    
  5. Custom gallery 控件的模板中,添加 音频 控件。

  6. 将 音频 控件的 Media 属性设置为以下公式:

    ThisItem.Url
    
  7. 按 F5 预览应用。

  8. 选择 MyMic 开始录制,然后再次选择停止录制。

  9. 控件中,选择音频控件中的播放按钮播放录制的内容。

  10. 根据需要添加多个录制内容,然后按 Esc 键返回到默认工作区。

  11. (可选)在 控件的模板中,添加 按钮 控件。

  12. 将其 OnSelect 属性设置为此公式:

    Remove( MySounds, ThisItem )
    
  13. 按 F5,然后通过选择相应的 按钮 控件来移除录音。

使用 SaveData 函数在本地保存录音,或使用 Patch 函数更新数据源。

辅助功能准则

适用 按钮 的相同准则,因为麦克风是专用按钮。 另外,请考虑以下事项:

音频替代项

请考虑为有语言障碍或没有麦克风的用户添加另一种输入形式。 例如,文本输入,允许用户输入文本。

颜色对比度

屏幕阅读器支持

另请参阅

Power Apps 中的控件限制

备注

您能告诉我们您的文档语言首选项吗? 进行简短调查。(请注意,此调查是英文版调查)

此调查大约需要七分钟。 不会收集个人数据(隐私声明)。