onCameraStatusChange()

onCameraStatusChange : ({ status, stream, video, config })

Description

onCameraStatusChange() est appelé lorsqu'un changement se produit lors de la demande d'autorisation de la caméra.

Appelé avec le statut et, le cas échéant, une référence aux nouvelles données disponibles. Le flux d'état typique est le suivant :

requesting -> hasStream -> hasVideo.

Paramètres

Paramètres	Description
statut	Un parmi [ 'requesting', 'hasStream', 'hasVideo', 'failed' ]
stream : [Facultatif]	Le MediaStream associé au flux de la caméra, si le statut est 'hasStream'.
vidéo : [Optionnel]	L'élément DOM vidéo affichant le flux, si le statut est hasVideo.
config	Les paramètres de configuration passés à XR8.run(), si le statut est 'requesting'.

Le paramètre status a les états suivants :

État	Description
demandant	Dans 'requesting', le navigateur ouvre la caméra et, le cas échéant, vérifie les permissions de l'utilisateur. Dans ce cas, il convient d'inviter l'utilisateur à accepter les autorisations de la caméra.
hasStream	Une fois que les autorisations de l'utilisateur sont accordées et que la caméra est ouverte avec succès, le statut passe à "hasStream" et toutes les invites de l'utilisateur concernant les autorisations peuvent être supprimées.
aVidéo	Une fois que les données de la caméra commencent à être disponibles pour le traitement, le statut passe à "hasVideo" et le flux de la caméra peut commencer à s'afficher.
échoué	Si le flux de la caméra ne s'ouvre pas, l'état est "échec". Dans ce cas, il est possible que l'utilisateur ait refusé des autorisations et il est donc conseillé de l'aider à les réactiver.

Exemple

XR8.addCameraPipelineModule({
  name : 'camerastartupmodule',
  onCameraStatusChange : ({status}) {
    if (status == 'requesting') {
      myApplication.showCameraPermissionsPrompt()
    } else if (status == 'hasStream') {
      myApplication.dismissCameraPermissionsPrompt()
    } else if (status == 'hasVideo') {
      myApplication.startMainApplictation()
    } else if (status == 'failed') {
      myApplication.promptUserToChangeBrowserSettings()
    }
  },
})