Zum Hauptinhalt springen

Anpassen der Videoaufzeichnung

Die XRExtras-Bibliothek von 8th Wall bietet Module , die sich mit den häufigsten Anforderungen von WebAR-Anwendungen befassen, einschließlich des Ladebildschirms, der Abläufe von Social Link-out und der Fehlerbehandlung.

Das XRExtras MediaRecorder Modul macht es einfach, die Videoaufzeichnung in Ihrem Projekt anzupassen.

In diesem Abschnitt wird beschrieben, wie Sie aufgezeichnete Videos anpassen können, z. B. das Verhalten der Aufnahmetaste (Tippen oder Halten), das Hinzufügen von Wasserzeichen, die maximale Videolänge, das Verhalten und Aussehen der Endkarte usw.

A-Frame-Primitive

xrextras-capture-button` : Fügt der Szene eine Aufnahmetaste hinzu.

ParameterTypStandardBeschreibung
AufnahmemodusStringStandardLegt das Verhalten des Aufnahmemodus fest. Standard: Tippen Sie auf , um ein Foto zu machen, tippen und halten Sie, um ein Video aufzunehmen. behoben: Tippen Sie auf , um die Videoaufnahme umzuschalten. Foto: Tippen Sie auf , um ein Foto aufzunehmen. Eines von [Standard, fest, Foto]

xrextras-capture-config : Konfiguriert die erfassten Medien.

ParameterTypStandardBeschreibung
max-duration-msint15000Gesamte Videodauer (in Millisekunden), die die Aufnahmetaste zulässt. Wenn die Endkarte deaktiviert ist, entspricht dies der maximalen Aufzeichnungszeit des Benutzers. 15000 standardmäßig.
max-Abmessungint1280Maximale Abmessung (Breite oder Höhe) des aufgenommenen Videos. Für die Fotokonfiguration siehe XR8.CanvasScreenshot.configure()
enable-end-cardBooleantrueOb die Endkarte auf dem Datenträger enthalten ist.
cover-image-urlStringBildquelle für das Umschlagbild der Endkarte. Verwendet standardmäßig das Titelbild des Projekts.
end-card-call-to-actionString'Probieren Sie es aus: '`Legt die Textzeichenfolge für die Aufforderung zum Handeln auf der Endkarte fest.
Kurz-LinkStringSetzt den Textstring für den Shortlink der Endkarte. Verwendet standardmäßig den Projektkurzlink.
footer-image-urlStringPowered by 8th Wall BildBildquelle für das Bild in der Fußzeile der Endkarte.
watermark-image-urlStringNullBildquelle für das Wasserzeichen.
watermark-max-widthint20Maximale Breite (%) des Wasserzeichenbildes.
watermark-max-heightint20Maximale Höhe (%) des Wasserzeichenbildes.
watermark-locationString'bottomRight'Ort des Wasserzeichenbildes. Eine von "topLeft, topMiddle, topRight, bottomLeft, bottomMiddle, bottomRight".
Dateinamen-PräfixString"mein-fang-Legt die Textzeichenfolge fest, die dem Dateinamen den eindeutigen Zeitstempel voranstellt.
Anfrage-MikrofonStringAuto'Legt fest, ob das Mikrofon während der Initialisierung ('auto') oder während der Laufzeit ('manual') eingerichtet werden soll
Szene-Audio einbindenBooleantrueWenn dies der Fall ist, werden die A-Frame-Sounds in der Szene in die Aufnahme einbezogen.

xrextras-capture-preview` : Fügt der Szene eine Medienvorschau hinzu, die das Abspielen, Herunterladen und Teilen ermöglicht.

ParameterTypStandardBeschreibung
aktionsschaltfläche-freigeben-textString''Aktie''Legt die Textzeichenfolge in der Aktionsschaltfläche fest, wenn Web Share API 2 verfügbar ist (Android, iOS 15 oder höher). Standardmäßig "Teilen".
action-button-view-textStringAnsicht''Legt die Textzeichenfolge in der Aktionsschaltfläche fest, wenn Web Share API 2 in iOS (iOS 14 oder niedriger) nicht verfügbar ist. Standardmäßig "Ansicht".

XRExtras.MediaRecorder Ereignisse

XRExtras.MediaRecorder gibt die folgenden Ereignisse aus.

Ereignisse Emittiert

Emittiertes EreignisBeschreibungEreignis Detail
mediarecorder-photocompleteWird nach der Aufnahme eines Fotos ausgestrahlt.{blob}
mediarecorder-recordcompleteWird nach Abschluss einer Videoaufzeichnung ausgegeben.{videoBlob}
mediarecorder-previewreadyWird ausgegeben, nachdem eine vorschaubare Videoaufnahme abgeschlossen ist. (nur Android/Desktop){videoBlob}
mediarecorder-finalizeprogressWird ausgegeben, wenn der Medienrekorder beim endgültigen Export Fortschritte macht. (nur Android/Desktop){progress, total}
mediarecorder-vorschau-geöffnetWird ausgegeben, nachdem die Aufnahmevorschau geöffnet wurde.null
mediarecorder-vorschau-geschlossenWird ausgegeben, nachdem die Aufnahmevorschau geschlossen wurde.null

Beispiel: A-Frame-Primitive

<xrextras-capture-button capture-mode="standard"></xrextras-capture-button>

<xrextras-capture-config
max-duration-ms="15000"
max-dimension="1280"
enable-end-card="true"
cover-image-url=""
end-card-call-to-action="Probieren Sie es aus unter:"
short-link=""
footer-image-url="//cdn.8thwall.com/web/img/almostthere/v2/poweredby-horiz-white-2.svg"
watermark-image-url="//cdn.8thwall.com/web/img/mediarecorder/8logo.png"
watermark-max-width="100"
watermark-max-height="10"
watermark-location="bottomRight"
file-name-prefix="my-capture-"
></xrextras-capture-config>

<xrextras-capture-preview
action-button-share-text="Teilen"
action-button-view-text="Anzeigen"
finalize-text="Exportieren..."
></xrextras-capture-preview>

Beispiel: A-Frame-Ereignisse

window.addEventListener('mediarecorder-previewready', (e) => {
console.log(e.detail.videoBlob)
})

Beispiel: Ändern Sie Share Button CSS

#actionButton {
/* Farbe der Aktionsschaltfläche ändern */
background-color: #007aff !important;
}