XR8.addCameraPipelineModule()
XR8.addCameraPipelineModule(Modul)`
Beschreibung
8th Wall-Kameraanwendungen werden mit Hilfe eines Kamera-Pipeline-Modul-Frameworks erstellt. Eine vollständige Beschreibung der Kamera-Pipeline-Module finden Sie unter CameraPipelineModule.
Anwendungen installieren Module, die dann das Verhalten der Anwendung zur Laufzeit steuern. Ein Modulobjekt muss eine Zeichenkette .name haben, die innerhalb der Anwendung eindeutig ist, und sollte dann eine oder mehrere der Lebenszyklusmethoden der Kamera bereitstellen, die an der entsprechenden Stelle in der Ausführungsschleife ausgeführt werden.
Während der Hauptlaufzeit einer Anwendung durchläuft jedes Kamerabild den folgenden Zyklus:
onBeforeRun
-> onCameraStatusChange
(requesting
-> hasStream
-> hasVideo
| failed
) -> onStart
-> onAttach
-> onProcessGpu
-> onProcessCpu
-> onUpdate
-> onRender
Kameramodule sollten eine oder mehrere der folgenden Methoden für den Lebenszyklus der Kamera implementieren:
Funktion | Beschreibung |
---|---|
onAppResourcesLoaded | Wird aufgerufen, wenn wir die mit einer Anwendung verbundenen Ressourcen vom Server erhalten haben. |
onAttach | Wird aufgerufen, bevor ein Modul zum ersten Mal Rahmenaktualisierungen empfängt. Sie wird für Module aufgerufen, die entweder vor oder nach der Ausführung der Pipeline hinzugefügt wurden. |
onBeforeRun | Unmittelbar nach XR8.run() aufgerufen. Wenn irgendwelche Versprechen zurückgegeben werden, wartet XR auf alle Versprechen, bevor es weitergeht. |
onCameraStatusChange | Wird aufgerufen, wenn bei der Abfrage der Kamerarechte eine Änderung eintritt. |
onCanvasSizeChange | Wird aufgerufen, wenn sich die Größe der Leinwand ändert. |
onDetach | wird aufgerufen, nachdem ein Modul zum letzten Mal Rahmenaktualisierungen erhalten hat. Dies geschieht entweder, nachdem der Motor abgestellt oder das Modul manuell aus der Rohrleitung entfernt wurde, je nachdem, was zuerst eintritt. |
onDeviceOrientationChange | Wird aufgerufen, wenn das Gerät die Ausrichtung im Quer-/Hochformat ändert. |
onException | Wird aufgerufen, wenn ein Fehler in XR auftritt. Wird mit dem Fehlerobjekt aufgerufen. |
onPaused | Wird aufgerufen, wenn XR8.pause() aufgerufen wird. |
onProcessCpu | Wird aufgerufen, um die Ergebnisse der GPU-Verarbeitung zu lesen und verwertbare Daten zurückzugeben. |
onProcessGpu | Wird aufgerufen, um die GPU-Verarbeitung zu starten. |
onRemove | wird aufgerufen, wenn ein Modul aus der Pipeline entfernt wird. |
onRender | Wird nach onUpdate aufgerufen. Dies ist der Zeitpunkt, an dem die Rendering-Engine alle WebGL-Zeichenbefehle ausgibt. Wenn eine Anwendung ihre eigene Ausführungsschleife bereitstellt und sich auf XR8.runPreRender() und XR8.runPostRender() verlässt, wird diese Methode nicht aufgerufen und das gesamte Rendering muss von der externen Ausführungsschleife koordiniert werden. |
onResume | Wird aufgerufen, wenn XR8.resume() aufgerufen wird. |
onStart | Wird beim Start von XR aufgerufen. Erster Rückruf nach dem Aufruf von XR8.run() . |
onUpdate | Wird aufgerufen, um die Szene vor dem Rendern zu aktualisieren. Daten, die von Modulen in onProcessGpu und onProcessCpu zurückgegeben werden, liegen als processGpu.modulename und processCpu.modulename vor, wobei der Name durch module.name = "modulename" gegeben ist. |
onVideoSizeChange | Wird aufgerufen, wenn sich die Größe der Leinwand ändert. |
requiredPermissions | Module können angeben, welche Browserfunktionen sie benötigen, für die möglicherweise Berechtigungsanfragen erforderlich sind. Diese können vom Framework verwendet werden, um die entsprechenden Berechtigungen anzufordern, wenn sie nicht vorhanden sind, oder um Komponenten zu erstellen, die die entsprechenden Berechtigungen anfordern, bevor XR ausgeführt wird. |
Hinweis: Kameramodule, die onProcessGpu
oder onProcessCpu
implementieren, können Daten an nachfolgende Stufen der Pipeline liefern. Dies geschieht über den Namen des Moduls.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Modul | Objekt | Das Modulobjekt. |
Rückgabe
Keine
Beispiel 1 - Ein Kamera-Pipelinemodul zur Verwaltung von Kamerazulassungen:
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()
}
},
})