Tempusxr English
Menu
  1. Documentation
  2. Construire avec le SDK

Capture photo et vidéo

Laissez les gens prendre une photo ou filmer une vidéo de votre expérience. Ce qui est enregistré est ce qu'ils voient : l'image réelle de la caméra et le contenu 3D ensemble, dans un seul fichier. Les boutons et les menus de l'interface ne sont pas dans l'image.

C'est optionnel : une page qui ne l'importe pas ne paie rien. Essayez sur un téléphone : l'exemple A-Frame et l'exemple Three.js.

Three.js

import { create } from '@tempusxr/sdk-three';
import { enableCapture } from '@tempusxr/sdk-capture'; // la ligne optionnelle

const ar = create({ container: '#ar' });
const capture = enableCapture(ar);

// Votre propre bouton, si vous préférez :
const photo = await capture.photo();   // { blob, url, width, height, type }
await capture.startVideo();
const clip = await capture.stopVideo();
await capture.share(photo);            // la feuille de partage sur téléphone, un téléchargement sur ordinateur

Avec loadScene(), donnez l'expérience qu'elle renvoie : enableCapture(experience.session).

A-Frame

Deux balises script de plus et un attribut, sans JavaScript :

<script src="tempusxr-capture.min.js"></script>
<script src="tempusxr-aframe-capture.min.js"></script>

<a-scene tempusxr="tracker: image; targets: poster.txr" tempusxr-capture="video: true; maxSize: 1920">

La scène envoie les événements tempusxr-photo et tempusxr-video avec le fichier dans event.detail. Dans un script, la capture est scene.components['tempusxr-capture'].capture.

Le déclencheur

Comme sur Snapchat, un grand bouton rond se trouve en bas au centre de l'écran :

Après une prise, un aperçu s'ouvre avec Partager, Enregistrer et Fermer. Le déclencheur se cache pendant l'aperçu, et pendant que l'expérience charge ou affiche une erreur. Une courte aide sous le bouton (« Touchez pour une photo, maintenez pour une vidéo ») disparaît après quelques secondes. Au clavier, Entrée ou Espace prend une photo.

Votre propre style : mettez un élément avec data-tx-shutter dans votre overlay et il reçoit les mêmes gestes à la place. data-tx-action="photo" et data-tx-action="record" sont de simples boutons (photo ; démarrer et arrêter). Coupez l'interface intégrée avec ui: false.

Le minuteur

Un bouton Minuteur dans la capsule de droite passe de coupé à 3 secondes puis 10 secondes, comme celui de Snapchat. Avec un minuteur, un toucher sur le déclencheur affiche un grand chiffre qui décompte sur la caméra, puis prend la photo. Un maintien lance une vidéo mains libres après le décompte, et un toucher sur le déclencheur l'arrête. Un toucher pendant le décompte l'annule. En code : capture.photo({ delay: 3 }), capture.startVideo({ delay: 3 }), l'événement countdown, capture.cancelCountdown(), et l'option timer pour une valeur par défaut.

Le son

Les vidéos portent le son de l'expérience : le son des vidéos et des fichiers audio d'une scène est enregistré avec l'image. Avec loadScene, donnez l'expérience à la capture et cela marche tout seul :

const experience = await loadScene(url, { container: '#ar' });
enableCapture(experience); // le son de la scène est dans les vidéos

L'option audio choisit le son : 'experience' (par défaut), 'microphone' (le téléphone demande d'abord), 'both' (mélangés en une piste), ou 'none'. microphone: true est un raccourci pour 'both'. Un fichier son d'un autre site doit autoriser la lecture depuis une autre adresse (Access-Control-Allow-Origin), sinon le navigateur le garde hors de l'enregistrement.

Options

OptionCe qu'elle fait
maxSizePlus grand côté d'une photo, en pixels. Par défaut 1920.
photoTypeimage/jpeg (par défaut) ou image/png.
video{ maxSize: 1280, fps: 30, maxSeconds: 60, bitsPerSecond }. Un enregistrement s'arrête seul à maxSeconds.
audioLe son des vidéos : 'experience' (par défaut), 'microphone', 'both' ou 'none'.
timerSecondes de décompte avant une prise (0, 3 ou 10 dans l'interface). 0 par défaut.
watermark{ image, text, position, size } : un logo ou un texte dans un coin.
holdMsCombien de temps la dernière image de la caméra est gardée pendant que la caméra redémarre. Par défaut 5000.
uiAjouter le déclencheur et l'aperçu. Activé par défaut.

Comment ça marche

La page montre deux couches : la vidéo de la caméra, et au-dessus le canvas 3D transparent. La capture dessine les deux dans un canvas caché, recadrées comme l'écran les recadre et inversées pour la caméra frontale, dans la même image, juste après le dessin de la 3D (c'est le seul moment où un canvas 3D garde son image). Ce canvas devient la photo, ou les images de la vidéo. Quand vous ne filmez pas, elle ne fait rien.

Redémarrages et suivi du monde

Un enregistrement ne dépend ni de la caméra ni du suivi, seulement de son propre canvas. Il continue donc quand la caméra redémarre, quand le suivi redémarre, quand vous changez de traqueur, ou quand la session est recréée. Pendant le trou, la dernière image de la caméra et la dernière image 3D sont gardées, pour que la vidéo ne clignote pas. Si la 3D cesse de se dessiner un instant, une photo est quand même prise.

Avec un traqueur où la plateforme possède l'image (suivi du monde avec WebXR, ou le pont iOS), la caméra n'a pas d'image vidéo à copier. Un fournisseur de caméra peut alors offrir drawBackdrop(context, width, height) pour dessiner lui-même l'image du monde réel. Quand il ne le peut pas (un navigateur qui ne donne pas accès à l'image de la caméra), les fichiers contiennent seulement le contenu 3D, et les photos sont des PNG à fond transparent. capture.hasCamera dit ce que vous obtenez.

Formats et limites