Mikrofon-Steuerelement in Power Apps

Artikel
09/29/2023

Ein Steuerelement, über das App-Benutzer mit ihren Geräten Ton aufnehmen können.

Beschreibung

Verwenden Sie das Mikrofon Steuerelement zum Aufnehmen von Audio mit dem Mikrofon eines Geräts. Das Gerät muss über ein Mikorfon verfügen und der Benutzer muss die App zur Verwendung des Mikrofons autorisieren.

Der zuletzt aufgenommene Audioclip ist über die Eigenschaft Audio abrufbar. Mit dieser Eigenschaft könnte aufgenommene Audio sein:

Wiedergabe mit der Audio-Steuerung. Verwenden Sie das Audio Steuerelement zum Anhören der Aufnahme. Weitere Informationen finden Sie unter Beispiele.
Vorübergehend in eine Variable oder eine Sammlung einfügen. Verwenden Sie die Funktionen Set oder Collect zum Speichern von Audioclips in einer Variablen oder einer Sammlung. Seien Sie vorsichtig, wenn Sie mehrere Bilder in einer Sammlung gleichzeitig verwenden und den begrenzten Speicher des Geräts beanspruchen. Verwenden Sie die Funktion SaveData und LoadData Funktionen zum Verschieben von Bildern in den lokalen Speicher auf dem Gerät und für Offline-Szenarien.
Daten, die in einer Datenbank gespeichert sind. Verwenden Sie die Patch Funktion zum Speichern von Audioclipsn in einer Datenbank.
Wird als base64-codierte Textzeichenfolge übertragen. Verwenden Sie die JSON Funktion zum Base64-Codieren von Audio-Clips.

Format des aufgenommenen Audios:

3gp Format für Android.
AAC Format für iOS.
OGG Format für Internetbrowser.

Aufgenommene Medien werden durch eine Textzeichenfolgen-URI referenziert. Weitere Informationen finden Sie in der Datentyp-Dokumentation.

Hinweis

Das Mikrofon-Steuerelement wird nur in Microsoft Edge basierend auf Chromium-, Chrome- und Firefox-Browsern sowie Android- und iOS-Geräten unterstützt. Alle anderen Browser und Plattformen zeigen eine Warnung an, dass einige Funktionen der App nicht funktionieren.

Wichtige Eigenschaften

Audio – Der Audioclip, der aufgenommen wird, wenn der Benutzer mit dem Mikrofon des Geräts aufzeichnet.

Mic - Numerische ID der Mikrofone auf einem Gerät, das mehr als ein Mikropohn hat.

OnStop – Auszuführende Aktionen, wenn der Benutzer die Aufzeichnung mit einem Mikrofon-Steuerelement beendet.

Zusätzliche Eigenschaften

AccessibleLabel - Bezeichnung für Sprachausgaben. Sollte den Zweck dieses Mikrofons beschreiben.

BorderColor - Die Farbe des Rahmens eines Steuerelements.

BorderStyle - Legt fest, ob der Rahmen eines Steuerelements Durgehend, Gestrichelt, Gepunktet oder Keine ist.

BorderThickness - Die Linienstärke des Rahmens eines Steuerelements.

Color – Die Farbe des Texts in einem Steuerelement.

DisplayMode - Legt fest, ob das Steuerelement Benutzereingaben zulässt (BEarbeiten), ob nur Daten angezeigt werden (Anzeigen) oder ob das Steuerelement deaktiviert ist (Deaktiviert).

DisabledBorderColor - Die Farbe des Steuerelementrahmens, wenn die DisplayMode-Eigenschaft des Steuerelements auf Deaktiviert festgelegt ist.

DisabledColor - Die Farbe des Texts in einem Steuerelement, wenn seine DisplayMode-Eigenschaft auf Deaktiviert festgelegt ist.

DisabledFill -Die Hintergrundfarbe eines Steuerelements, wenn dessen DisplayMode-Eigenschaft auf Deaktiviert festgelegt ist.

Fill - Die Hintergrundfarbe eines Steuerelements.

FocusedBorderColor - Die Rahmenfarbe eines Steuerelements, wenn das Steuerelement der Fokus ist.

FocusedBorderThickness - Die Rahmendicke eines Steuerelements, wenn das Steuerelement der Fokus ist.

Height - Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.

HoverBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über das Steuerelement hält.

HoverColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer den Mauszeiger über ihm hält.

HoverFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über ihm hält.

Image: - Der Name des Bilds, das in einem Bild-, Audio- oder Mikrofon-Steuerelement angezeigt wird.

ImagePosition: Die Position (Füllen, Passend, Stretch, Kachel oder Center) eines Bilds auf einem Bildschirm oder in einem Steuerelement, wenn die Größe nicht mit der Bildgröße identisch ist.

OnSelect – Auszuführende Aktionen, wenn der Benutzer ein Steuerelement auswählt.

OnStart – Auszuführende Aktionen, wenn der Benutzer die Aufzeichnung mit einem Mikrofon-Steuerelement startet.

PressedBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer das Steuerelement auswählt.

PressedColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer das Steuerelement auswählt.

PressedFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer dieses Steuerelement auswählt.

Reset - Gibt an, ob ein Steuerelement auf seinen Standardwert zurückgesetzt wird.

TabIndex - Navigationsreihenfolge der Tastatur in Bezug auf andere Steuerelemente.

Tooltip - Erklärender Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.

Visible - Gibt an, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.

Width - Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.

X - Der Abstand zwischen dem linken Rand der Komponente und dem linken Rand des übergeordneten Behältnis oder Bildschirms.

Y- Der Abstand zwischen dem oberen Rand der Komponente und dem oberen Rand des übergeordneten Behältnis oder Bildschirms.

Beispiele

Einfache direkte Wiedergabe

In diesem Beispiel verbinden wir ein Mikrofon Steuerelement mit einem Audio Steuerelement für sofortige Wiedergabe:

Fügen Sie ein Mikrofon Steuerelement zu Ihrer App hinzu.
Autorisieren Sie die App, das Mikrofon des Geräts zu verwenden, wenn Sie dazu aufgefordert werden.
Fügen Sie das Audio-Steuerelement zu Ihrer App hinzu.
Legen Sie die Audio Steuerung der Media Eigenschaft auf die Formel fest.
```
Microphone1.Audio
```
Hinweis

Ersetzen Sie den Namen des Mikrofon-Steuerelements Mikrofon 1 wie angemessen.
Vorschau der App.
WählenSie das Mikrofon Steuerelement, um die Aufnahme zu starten.
Sprechen Sie, um Audio aufzunehmen.
WählenSie das Mikrofon Steuerelement, um die Aufnahme zu beenden.
WählenSie das Audio Steuerelement, um die Aufnahme zu starten.

Hinzufügen von Tönen zu einem benutzerdefinierten Katalog-Steuerelement

In diesem Beispiel erstellen wir eine Galerie mit Audioclips, die in einer Sammlung gespeichert sind und für die Wiedergabe einzeln ausgewählt werden können:

Fügen Sie ein Mikrofon Steuerelement hinzu.
Legen Sie seine OnStop Eigenschaft zu dieser Formel mit der Funktion Collect fest:
```
Collect( MySounds, MyMic.Audio )
```
Fügen Sie ein Steuerelement Katalog hinzu und bewegen sie es unter MyMic.
Legen Sie die Items Eigenschaft des Katalogs auf diese Formel fest:
```
MySounds
```
In der Vorlage für das Steuerelement Custom gallery fügen Sie das Steuerelement Audio hinzu.
Legen Sie das Audio Steuerelement der Media Eigenschaft auf diese Formel fest.
```
ThisItem.Url
```
Drücken Sie F5, um eine Vorschau Ihrer App anzuzeigen.
Wählen MyMic, um die Aufnahme zu starten, und wählen Sie sie erneut aus, um die Aufnahme zu beenden.
Im Steuerelement Katalog wählen Sie die Play-Schaltfläche im Steuerelement Audio, um Ihre Aufnahme abzuspielen.
Fügen Sie eine beliebig große Anzahl von Aufzeichnungen ein, und kehren Sie anschließend durch Drücken von ESC in den Standardarbeitsbereich zurück.
(optional) In der Vorlage für das Steuerelement Katalog fügen Sie das Steuerelement Schaltfläche hinzu.
Legen Sie die OnSelect-Eigenschaft auf die folgende Formel fest:
```
Remove( MySounds, ThisItem )
```
Drücken Sie F5 und entfernen Sie eine Aufnahme, indem Sie das entsprechende Schaltfläche Steuerelement auswählen.

Verwenden Sie die SaveData-Funktion, um die Aufzeichnungen lokal zu speichern, oder die Patch-Funktion, um eine Datenquelle zu aktualisieren.

Richtlinien für Barrierefreiheit

Es gelten dieselben Richtlinien wie für Schaltfläche, da ein Mikrofon nur eine besondere Schaltfläche ist. Beachten Sie auch:

Audioalternativen

Sie sollten eine alternative Eingabemöglichkeit für Benutzer hinzufügen, die eine Sprachbehinderung haben oder nicht über ein Mikrofon verfügen. Z.B. eine Texteingabe, über die Benutzer Text eingeben können.

Farbkontrast

Lesen Sie die Standardanforderungen für Farbkontraste.
Stellen Sie einen ausreichenden Farbkontrast zwischen Image und dem Schaltflächentext und de Symbol her (falls zutreffend).

Screenreadersupport

AccessibleLabel muss vorhanden sein.

Siehe auch

Einschränkungen der Steuerelemente in Power Apps