XR8.MediaRecorder.configure()

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

Description

Configure divers paramètres du MediaRecorder.

Paramètres

Paramètres	Type	Défaut	Description
coverImageUrl [Optionnel]	Chaîne	Image de couverture configurée dans le projet, null sinon	Source de l'image de couverture.
enableEndCard [Facultatif]	Chaîne	faux	Si vrai, activez la carte d'extrémité.
endCardCallToAction [Optionnel]	Chaîne	'essayez-le à : '	Définit la chaîne de texte pour l'appel à l'action.
préfixe du nom de fichier [Facultatif]	Chaîne	'my-capture-'	Définit la chaîne de texte qui ajoute la marque unique au nom du fichier.
footerImageUrl [Optionnel]	Chaîne	nul	Image src pour l'image de couverture.
foregroundCanvas [Facultatif]	Chaîne	nul	Le support à utiliser comme premier plan dans la vidéo enregistrée.
maxDurationMs [Optionnel]	Nombre	15000	Durée maximale de la vidéo, en millisecondes.
maxDimension [Facultatif]	Nombre	1280	Dimension maximale de l'enregistrement capturé, en pixels.
shortLink [Facultatif]	Chaîne	8th.io shortlink depuis le tableau de bord du projet	Définit la chaîne de texte pour le lien court.
configureAudioOutput [Optionnel]	Objet	nul	Fonction fournie par l'utilisateur qui recevra les nœuds audio microphoneInput et audioProcessor pour un contrôle complet de l'audio de l'enregistrement. Les nœuds attachés au nœud de processeur audio feront partie de l'audio de l'enregistrement. Il doit renvoyer le nœud final du graphe audio de l'utilisateur.
audioContext [Facultatif]	Chaîne	nul	Instance de AudioContext fournie par l'utilisateur. Des moteurs comme three.js et BABYLON.js ont leur propre instance audio interne. Pour que les enregistrements contiennent des sons définis dans ces moteurs, vous devrez fournir leur instance AudioContext.
requestMic [Facultatif]	Chaîne	auto	Détermine le moment où les autorisations audio sont demandées. Les options sont fournies à l'adresse XR8.MediaRecorder.RequestMicOptions.

La fonction transmise à configureAudioOutput prend un objet avec les paramètres suivants :

Paramètres	Description
microphoneInput	Un GainNode `` qui contient l'entrée micro de l'utilisateur. Si les autorisations de l'utilisateur ne sont pas acceptées, ce nœud n'émettra pas l'entrée micro mais sera toujours présent.
audioProcessor	un ScriptProcessorNode `` qui transmet les données audio à l'enregistreur. Si vous souhaitez qu'un nœud audio fasse partie de la sortie audio de l'enregistrement, vous devez le connecter à l'audioProcessor.

Retours

Aucun

Exemple

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

Exemple - sortie audio configurée par l'utilisateur

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

  // Connectez le nœud final du graphique audio au matériel.
  myCustomAudioGraph.connect(microphoneInput.context.destination)

  // Le graphique audio sera automatiquement connecté au processeur.
  return myCustomAudioGraph
}
const threejsAudioContext = THREE.AudioContext.getContext()
XR8.MediaRecorder.configure({
  configureAudioOutput : userConfiguredAudioOutput,
  audioContext : threejsAudioContext,
  requestMic : XR8.MediaRecorder.RequestMicOptions.AUTO,
})