Элемент управления Микрофон в Power Apps

Статья
03/25/2024

Элемент управления, позволяющий пользователям записывать звук на устройстве.

Описание

Используйте элемент управления Микрофон для записи звука с помощью микрофона устройства. Устройство должно иметь микрофон, и пользователь должен разрешить приложению использовать микрофон.

Последний записанный аудиоклип доступен через свойство Audio. С этим свойством с записанным звуком можно выполнять следующие действия:

Воспроизведение в элементе управления Аудио. Используйте элемент управления Аудио для прослушивания записи. Дополнительные сведения см. в примерах.
Временно поместить в переменную или коллекцию. Используйте функции Set или Collect для сохранения аудиоклипов в переменной или коллекции. Будьте осторожны с несколькими аудиоклипами в коллекции одновременно на устройствах с ограниченным объемом памяти. Используйте функции SaveData и LoadData для перемещения аудиоклипов в локальное хранилище на устройстве и для автономных сценариев.
Сохранение в базе данных. Используйте функцию Patch для сохранения аудиоклипов в базе данных.
Передается как текстовая строка в кодировке base64. Используйте функции JSON для кодирования аудиоклипов в кодировке base64.

Формат записанного аудио:

Формат 3gp для Android.
Формат AAC для iOS.
Формат OGG для веб-браузеров.

На снятые объекты мультимедиа ссылается URI в виде текстовой строки. Дополнительные сведения см. в документации по типам данных.

Примечание

Элемент управления Микрофон поддерживается только в браузерах Microsoft Edge на базе Chromium, Chrome и Firefox, а также на устройствах с Android и iOS. Все остальные браузеры и платформы будут показывать предупреждение о том, что некоторые функции приложения не будут работать.

Ограничения

Элемент управления «Микрофон» имеет следующие ограничения:

Power Apps Mobile поддерживает множество типов устройств, и некоторые из них имеют ограничения, относящиеся только к конкретной платформе:
- Вы можете воспроизводить видео, используя множество элементов управления Видео одновременно на всех платформах, кроме устройств iPhone.
- Вы можете записывать звук с использованием множества элементов управления Микрофон одновременно на всех платформах, кроме веб-проигрывателя.

Ключевые свойства

Audio — аудиоклип, снятый при записи пользователем с помощью микрофона устройства.

Mic — числовой идентификатор микрофона на устройстве с несколькими микрофонами.

OnStop — действия, выполняемые, когда пользователь останавливает запись с помощью элемента управления "Микрофон".

Дополнительные свойства

AccessibleLabel — метка для средств чтения с экрана. Необходимо описать назначение микрофона.

BorderColor — цвет границы элемента управления.

BorderStyle — стиль границы элемента управления: Solid, Dashed, Dotted или None.

BorderThickness — толщина границы элемента управления.

Color — цвет текста в элементе управления.

DisplayMode — в зависимости от значения этого режима элемент управления разрешает пользователю вводить данные (Изменение), только отображает данные (Просмотр) или элемент вообще отключен (Отключено).

DisabledBorderColor — цвет границы элемента управления, если для его свойства DisplayMode установлено значение Отключено.

DisabledColor — цвет текста в элементе управления, если для его свойства DisplayMode установлено значение Отключено.

DisabledFill — цвет фона элемента управления, если для его свойства DisplayMode установлено значение Отключено.

Fill — цвет фона элемента управления.

FocusedBorderColor — цвет границы элемента управления в тот момент, когда он активен.

FocusedBorderThickness — толщина границы элемента управления при наведении фокуса.

Height — расстояние между верхним и нижним краями элемента управления.

HoverBorderColor — цвет границы элемента управления при наведении на него указателя мыши.

HoverColor — цвет текста в элементе управления при наведении на него указателя мыши.

HoverFill — цвет фона элемента управления при наведении на него указателя мыши.

Изображение — имя изображения, которое отображается в элементе управления Изображение, Аудио или Микрофон.

ImagePosition — расположение изображения на экране или в элементе управления, если его размеры отличаются от размеров изображения (Fill, Fit, Stretch, Tile или Center).

OnSelect — действия, выполняемые, когда пользователь выбирает элемент управления.

OnStart — действия, выполняемые, когда пользователь начинает запись с помощью элемента управления "Микрофон".

PressedBorderColor — цвет границы элемента управления, когда пользователь выбирает этот элемент управления.

PressedColor — цвет текста в элементе управления, когда пользователь выбирает этот элемент управления.

PressedFill — цвет фона элемента управления, когда пользователь выбирает этот элемент управления.

Reset — определяет, возвращается ли элемент управления к значению по умолчанию.

TabIndex — порядок навигации с помощью клавиатуры относительно других элементов управления.

Tooltip — пояснительный текст, отображаемый при наведении указателя мыши на элемент управления.

Visible — определяет, отображается элемент управления или он скрыт.

Width — расстояние между левым и правым краями элемента управления.

X — расстояние между левым краем элемента управления и левым краем его родительского контейнера или экрана.

Y — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера или экрана.

Примеры

Простое прямое воспроизведение

В этом примере мы напрямую подключим элемент управления Микрофон к элементу управления Аудио для немедленного воспроизведения:

Добавьте элемент управления Микрофон в свое приложение.
Разрешите приложению использовать микрофон устройства, если будет предложено.
Добавьте элемент управления Аудио в свое приложение.
Установите в элементе управления Аудио для свойства Мультимедиа формулу:
```
Microphone1.Audio
```
Примечание

Замените имя элемента управления Микрофон Раскрывающийся список1 на требуемое имя.
Предварительно просмотрите приложение.
Выберите элемент управления Микрофон, чтобы начать запись.
Говорите, чтобы записать звук.
Снова выберите элемент управления Микрофон, чтобы завершить запись.
Выберите элемент управления Аудио, чтобы прослушать запись.

Добавление звуков в элемент управления Галерея

В этом примере мы создадим коллекцию аудиоклипов, хранящихся в коллекции, которую можно выбрать для воспроизведения по отдельности:

Добавьте элемент управления Микрофон.
Установите для его свойства OnStop следующую формулу с помощью функции Collect:
```
Collect( MySounds, MyMic.Audio )
```
Добавьте элемент управления Галерея и переместите его под MyMic.
Задайте для свойства Items для коллекции следующую формулу:
```
MySounds
```
В шаблоне для элемента управления Custom gallery добавьте элемент управления Аудио.
Установите в элементе управления Аудио для свойства Мультимедиа формулу:
```
ThisItem.Url
```
Нажмите F5 для предварительного просмотра приложения.
Выберите MyMic, чтобы начать запись, затем выберите его еще раз, чтобы остановить запись.
В элементе управления Галерея выберите кнопку воспроизведения в элементе управления Аудио, чтобы воспроизвести запись.
Добавьте столько записей, сколько хотите, затем вернитесь в рабочую область по умолчанию, нажав клавишу Esc.
(необязательно) В шаблоне для элемента управления Галерея добавьте элемент управления Кнопка.
Задайте для свойства OnSelect следующую формулу:
```
Remove( MySounds, ThisItem )
```
Нажмите F5, затем удалите запись, выбрав соответствующий элемент управления Кнопка.

Для локального сохранения записей используйте функцию SaveData, а для обновления источника данных — функцию Patch.

Руководство по настройке специальных возможностей

Те же правила применяются к элементу управления Кнопка, так как элемент Микрофон — это просто специализированная кнопка. Также рассмотрим:

Варианты для аудио

Попробуйте добавить альтернативную форму ввода данных для пользователей с ослабленной речью с микрофоном или без него. Например, элемент управления Ввод текста, чтобы разрешить пользователям вводить текст.

Контрастность цветов

Прочитайте стандартные требования по цветовому контрасту.
Обеспечьте адекватный цветовой контраст между Изображением и текстом кнопки и значком (если применимо).

Поддержка средства чтения с экрана

Должен присутствовать элемент AccessibleLabel.

См. также

Ограничения элементов управления в Power Apps