- Documentation
- 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 :
- Touchez-le pour une photo.
- Maintenez-le pour une vidéo. Un anneau rouge se remplit autour du bouton pendant la durée maximale, et une horloge affiche le temps. Relâchez pour arrêter.
- Glissez vers le haut en maintenant pour verrouiller l'enregistrement : vous avez les mains libres, et un toucher sur le bouton l'arrête.
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
| Option | Ce qu'elle fait |
|---|---|
maxSize | Plus grand côté d'une photo, en pixels. Par défaut 1920. |
photoType | image/jpeg (par défaut) ou image/png. |
video | { maxSize: 1280, fps: 30, maxSeconds: 60, bitsPerSecond }. Un enregistrement s'arrête seul à maxSeconds. |
audio | Le son des vidéos : 'experience' (par défaut), 'microphone', 'both' ou 'none'. |
timer | Secondes 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. |
holdMs | Combien de temps la dernière image de la caméra est gardée pendant que la caméra redémarre. Par défaut 5000. |
ui | Ajouter 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
- Format vidéo : le navigateur choisit. Les iPhone enregistrent en MP4, Chrome et Android en MP4 ou WebM. Certaines applications n'acceptent pas le WebM ; une page ne peut pas le convertir.
- Son : une vidéo porte le son de l'expérience, et le micro si vous le demandez.
- Durée : 60 secondes au plus par défaut, pour qu'un enregistrement oublié ne remplisse pas le téléphone.
- Page cachée : si la personne quitte la page, l'enregistrement se termine et est gardé (
interrupted: true). - Vie privée : rien n'est envoyé. Les fichiers restent sur l'appareil, et leurs adresses sont libérées quand l'aperçu se ferme.