Mikrofon

Übersicht

Die Avonni-Mikrofonkomponente ermöglicht es Benutzern, Audio mithilfe des Mikrofons eines Geräts innerhalb von Salesforce Dynamic Components oder Flows aufzunehmen. Sie ist zum Erfassen von Sprachnotizen, Besprechungsaufnahmen oder Audio-Feedback gedacht und bietet Optionen, Aufnahmen als Salesforce ContentDocument-Objekte (Dateien) zu speichern.

• Sprachnotizen für Kundeninteraktionen auf Account-/Kontaktseiten erfassen.

• Besprechungszusammenfassungen für Projektakten aufzeichnen.

• Audio-Feedback in Supportfällen oder Umfragen sammeln.

• Mündliche Anweisungen für Außendienstaufgaben protokollieren.

• Aufzeichnungen von Schulungssitzungen speichern und mit benutzerdefinierten Objekten verknüpfen.

Konfiguration

Wählen Sie die Mikrofonkomponente auf der Arbeitsfläche aus, um Eigenschaften im rechten Eigenschaftenbereich aufzurufen.

Grundlegende Eigenschaften

Diese steuern das Aufnahmeverhalten und die Datenverarbeitung.

Eigenschaft	Typ	Beschreibung	Beispiel
API-Name	Text	Eindeutiger Bezeichner für die Instanz.	MicRecorder
Als Content Document speichern	Boolesch	Wenn eingeschaltet, speichert die Aufnahme als ContentDocument (Datei) in Salesforce.	Ein
Mehrere Aufnahmen zulassen	Boolesch	Wenn eingeschaltet, werden mehrere Aufnahmen in einer Sitzung ermöglicht und als ContentDocuments gespeichert.	Aus
Wert	Bindung	Speichert die aufgezeichneten Audiodaten (zugänglich über $Component.MicRecorder.Value).	An Variable binden zur Verarbeitung
Visualisierer anzeigen	Boolesch	Zeigt während der Aufnahme eine Echtzeit-Audiowellenform an.	Ein

Beste Vorgehensweise: Aktivieren Sie "Als Content Document speichern" für persistente Speicherung; verwenden Sie "Visualisierer anzeigen" für Benutzerfeedback während der Aufnahme.

Content Document-Einstellungen (aktiv, wenn "Als Content Document speichern" eingeschaltet ist)

Diese konfigurieren, wie Aufnahmen als Dateien gespeichert werden.

Eigenschaft	Typ	Beschreibung	Beispiel
Titel des Content Documents	Text	Titel für die gespeicherte ContentDocument-Datei.	"Meeting_Note_{!Record.Id}"
Verknüpftes Entity Id des Content Documents	Text/Bindung	Datensatz-ID, um die Datei zu verknüpfen (z. B. Account, Case).	{!Record.Id}

Beschriftungsabschnitt

Text für UI-Elemente anpassen.

Eigenschaft	Typ	Beschreibung	Beispiel
Bereit-Label	Text	Text, wenn bereit zur Aufnahme.	"Aufnahme starten"
Aufnahme-Label	Text	Text während der aktiven Aufnahme.	"Aufnahme..."
Pause-Button-Label	Text	Text für die Pausenschaltfläche.	"Pause"
Abbrechen-Button-Label	Text	Text für die Abbrechen-Schaltfläche.	"Abbrechen"

Interaktionen-Tab

Aktionen beim Abschluss der Aufnahme definieren.

Eigenschaft	Typ	Beschreibung
Beim Klick auf "Speichern als"-Schaltfläche	Einstellungen	Beim Speichern auslösen: Verwenden Sie $Component.MicRecorder.Value für Audiodaten (z. B. Toast anzeigen, Navigieren, Datensatz aktualisieren).

Beispiele

Beispiel 1: Einzelne Sprachnotiz für Case

Dieses Beispiel nimmt eine Sprachnotiz für einen Case auf und speichert sie als Datei.

1. Mikrofon konfigurieren:

   • API-Name: CaseNoteRecorder

   • Als Content Document speichern: Ein

   • Titel des Content Documents: "Case_Note_{!Record.Id}"

   • Verknüpftes Entity Id des Content Documents: {!Record.Id} (mit Case verknüpft)

   • Visualisierer anzeigen: Ein

   • Bereit-Label: "Notiz aufnehmen"

   • Aufnahme-Label: "Notiz wird aufgenommen..."

   • Pause-Button-Label: "Pause"

   • Abbrechen-Button-Label: "Stoppen"

2. Interaktion hinzufügen:

   • Beim Klick auf "Speichern als"-Schaltfläche: Toast mit der Meldung "Sprachnotiz für Case gespeichert." anzeigen.

Ergebnis: Benutzer nehmen eine Notiz auf, sehen eine Wellenform und speichern sie als ContentDocument, das mit dem Case verknüpft ist, mit einer Bestätigungs-Toastmeldung.

Beispiel 2: Mehrere Feedback-Aufnahmen

Dieses Beispiel ermöglicht mehrere Audio-Feedback-Aufnahmen für eine Umfrage.

1. Mikrofon konfigurieren:

   • API-Name: FeedbackRecorder

   • Als Content Document speichern: Ein

   • Mehrere Aufnahmen zulassen: Ein

   • Titel des Content Documents: "Feedback_{!Record.Id}_{$System.Timestamp}"

   • Verknüpftes Entity Id des Content Documents: {!Record.Id}

   • Visualisierer anzeigen: Ein

   • Bereit-Label: "Feedback starten"

   • Abbrechen-Button-Label: "Beenden"

2. Interaktion hinzufügen:

   • Beim Klick auf "Speichern als"-Schaltfläche: $Component.FeedbackRecorder.Value zu einer Collection-Variable hinzufügen; eine Listenkomponente aktualisieren, um gespeicherte Dateien anzuzeigen.

Ergebnis: Benutzer nehmen mehrere Feedback-Clips auf, die jeweils als ContentDocument gespeichert werden, wobei eine Liste aktualisiert wird, um alle Aufnahmen anzuzeigen.

Wichtige Überlegungen

• Datenspeicherung: Aktivieren Sie "Als Content Document speichern", um Audio als Dateien persistent zu speichern; binden Sie die verknüpfte Entity Id an relevante Datensätze.

• Mehrere Aufnahmen: Verwenden Sie "Mehrere Aufnahmen zulassen" für Szenarien mit vielen Aufnahmen; stellen Sie sicher, dass Titel eindeutig sind (z. B. durch Einbeziehung von Zeitstempeln).

• Visualisierer: Aktivieren Sie ihn für Echtzeit-Feedback, insbesondere auf mobilen Geräten.

• Interaktionen: Verwenden Sie $Component.API_Name.Value für Audiodaten in Flows oder Aktualisierungen; testen Sie Dateispeicherlimits.

• Beschriftungen: Passen Sie sie zur Verständlichkeit an; stellen Sie sicher, dass Pause/Abbrechen für Benutzer intuitiv sind.

• Barrierefreiheit: Stellen Sie klare Beschriftungstexte bereit; testen Sie die Kompatibilität des Visualisierers mit Screenreadern.

Fehlerbehebung bei häufigen Problemen

• Recorder öffnet sich nicht: Überprüfen Sie die Mikrofonberechtigungen des Geräts; stellen Sie sicher, dass sie nicht deaktiviert sind.

• Kein Audio gespeichert: Überprüfen Sie, ob "Als Content Document speichern" eingeschaltet ist; prüfen Sie die Bindungen für Titel des Content Documents/verknüpfte Entity Id.

• Mehrere Aufnahmen schlagen fehl: Stellen Sie sicher, dass "Mehrere Aufnahmen zulassen" eingeschaltet ist; testen Sie Speicherquoten.

• Visualisierer fehlt: Schalten Sie "Visualisierer anzeigen" um; prüfen Sie die Browserkompatibilität.

• Interaktionsfehler: Bestätigen Sie die Bindung $Component.API_Name.Value; testen Sie mit statischen Daten.

• UI-Unordnung: Passen Sie den Beschriftungstext zur Kürze an; testen Sie auf Mobilgeräten die Sichtbarkeit der Schaltflächen.

Zusammenfassung

Die Avonni-Mikrofonkomponente vereinfacht die Audioerfassung in Salesforce und bietet Optionen für einzelne oder mehrere Aufnahmen, Dateispeicherung und dynamische Interaktionen. Sie eignet sich perfekt für Sprachnotizen, Feedback oder Dokumentation.