XR8.MediaRecorder.configure()

XR8.MediaRecorder.configure({ coverImageUrl, enableEndCard, endCardCallToAction, footerImageUrl, foregroundCanvas, maxDurationMs, maxDimension, shortLink, configureAudioOutput, audioContext, requestMic })`

Beschreibung

Konfiguriert verschiedene MediaRecorder-Parameter.

Parameter

Parameter	Typ	Standard	Beschreibung
coverImageUrl [Optional]	String	Im Projekt konfiguriertes Titelbild, sonst null.	Bildquelle für das Titelbild.
enableEndCard [Optional]	String	false	Wenn true, wird die Endkarte aktiviert.
endCardCallToAction [Optional]	String	'Probieren Sie es aus: '`	Legt die Textzeichenfolge für den Aufruf zur Aktion fest.
fileNamePrefix [Optional]	String	"mein-fang-	Legt die Textzeichenfolge fest, die dem Dateinamen den eindeutigen Zeitstempel voranstellt.
footerImageUrl [Optional]	String	Null	Bild src für Titelbild.
foregroundCanvas [Optional]	String	Null	Die Leinwand, die im aufgezeichneten Video als Vordergrund verwendet werden soll.
maxDurationMs [Optional]	Nummer	15000	Maximale Dauer des Videos, in Millisekunden.
maxDimension [Optional]	Nummer	1280	Maximale Größe der aufgenommenen Aufnahme in Pixeln.
shortLink [Optional]	String	8th.io-Verknüpfung vom Projekt-Dashboard	Legt die Textzeichenfolge für den Shortlink fest.
configureAudioOutput [Optional]	Objekt	Null	Vom Benutzer bereitgestellte Funktion, die die Audioknoten microphoneInput und audioProcessor empfängt, um die vollständige Kontrolle über den Ton der Aufnahme zu erhalten. Die mit dem Audioprozessorknoten verbundenen Knoten sind Teil des Tons der Aufnahme. Es ist erforderlich, den Endknoten des Audiographen des Benutzers zurückzugeben.
audioContext [Optional]	String	Null	Vom Benutzer bereitgestellte AudioContext-Instanz. Engines wie three.js und BABYLON.js haben ihre eigene interne Audio-Instanz. Damit die Aufnahmen Sounds enthalten, die in diesen Engines definiert sind, müssen Sie deren AudioContext-Instanz bereitstellen.
requestMic [Optional]	String	Auto'	Legt fest, wann die Audiorechte angefordert werden. Die Optionen werden in [XR8.MediaRecorder.RequestMicOptions] (requestmicoptions.md) bereitgestellt.

Die Funktion, die an configureAudioOutput übergeben wird, nimmt ein Objekt mit den folgenden Parametern an:

Parameter	Beschreibung
MikrofonEingang	Ein GainNode, der den Mikrofoneingang des Benutzers enthält. Wenn die Berechtigungen des Benutzers nicht akzeptiert werden, gibt dieser Knoten den Mikrofoneingang nicht aus, ist aber dennoch vorhanden.
audioProzessor	ein ScriptProcessorNode, der Audiodaten an den Rekorder übergibt. Wenn Sie möchten, dass ein Audioknoten Teil der Audioausgabe der Aufnahme ist, müssen Sie ihn mit dem audioProcessor verbinden.

Rückgabe

Keine

Beispiel

XR8.MediaRecorder.configure({
  maxDurationMs: 15000,
  enableEndCard: true,
  endCardCallToAction: 'Try it at:',
  shortLink: '8th.io/my-link',
})

Beispiel - vom Benutzer konfigurierter Audioausgang

const userConfiguredAudioOutput = ({microphoneInput, audioProcessor}) => {
  const myCustomAudioGraph = ...
  myCustomAudioSource.connect(myCustomAudioGraph)
  microphoneInput.connect(myCustomAudioGraph)

  // Endknoten des Audiographen mit der Hardware verbinden.
  myCustomAudioGraph.connect(microphoneInput.context.destination)

  // Der Audiograph wird automatisch mit dem Prozessor verbunden.
  return myCustomAudioGraph
}
const threejsAudioContext = THREE.AudioContext.getContext()
XR8.MediaRecorder.configure({
  configureAudioOutput: userConfiguredAudioOutput,
  audioContext: threejsAudioContext,
  requestMic: XR8.MediaRecorder.RequestMicOptions.AUTO,
})