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	false	Si c'est le cas, activer la carte d'extrémité.
endCardCallToAction [Optionnel]	Chaîne	"Essayez-le : '`	Définit la chaîne de texte de l'appel à l'action.
Préfixe du nom de fichier [Facultatif]	Chaîne	'my-capture-'''.	Définit la chaîne de texte qui ajoute l'horodatage unique au nom du fichier.
footerImageUrl [Optionnel]	Chaîne	null	Image src pour l'image de couverture.
foregroundCanvas [Facultatif]	Chaîne	null	La toile à 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	null	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	null	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 devez fournir leur instance AudioContext.
requestMic [Facultatif]	Chaîne	'auto'	Détermine le moment où les autorisations audio sont demandées. Les options sont fournies dans XR8.MediaRecorder.RequestMicOptions.

La fonction passée à 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.

Retourne

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)

  // Connecter 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,
})