[JAVA] THETA Plug-In Entwicklung (über Theta-Plugin-SDK)

Überprüfen Sie den Inhalt des SDK für die Entwicklung des THETA-Plug-Ins (theta-plugin-sdk), das auf github veröffentlicht wurde.

Aktualisiert am 24. Januar 2020: Aktualisiert auf das neueste SDK (SDK Version 1.0.2-> Version 2.1.0). Fehlerhafte Links behoben.

1. Zuallererst

RICOH THETA V besteht aus Android-Betriebssystemen und unterstützte zunächst keine Plug-Ins, aber [RICOH THETA V] Ende Juni Mit dem Start des Plugin-Partnerprogramms](https://theta360.com/ja/info/news/2018-06-28-01/) können Sie Ihre eigene Android-App (= Plugin) installieren. Überprüfen Sie das SDK und die Dokumentation hier.

• SDK : https://github.com/ricohapi/theta-plugin-sdk
• Dokument: https://api.ricoh/docs/theta-plugin/how-to-develop/

Um das entwickelte Plug-In über den Befehl adb auf dem Hauptteil von THETA zu installieren, müssen Sie sich als Entwickler des THETA-Plugins registrieren (ein Foto der tatsächlichen THETA V- oder Z1-Maschine ist erforderlich). Die Site befindet sich in der RICOH-Entwicklerverbindung, aber die Plug-in-Entwicklerregistrierung hat nichts mit "RICOH-Konto" zu tun, sodass Sie kein RICOH-Konto erstellen müssen.

• Registrierung von Plug-in-Entwicklern: RICOH THETA Plug-in-Partnerprogramm
• Registrierung registrierter Konten: RICOH THETA Plug-in-Partnerprogramm (Profil)
• Registrieren Sie das entwickelte Plug-In: RICOH THETA Plug-In-Partnerprogramm (Partnermenü)

2. Inhalt von theta-plugin-sdk

Öffnen Sie theta-plugin-sdk (Version 2.1.0), das von github in Android Studio geklont wurde. Der Quellcode ist in zwei Teile unterteilt: App- und Plugin-Bibliothek. In app werden Klassen wie das Netzwerk implementiert. Bis zu Version 1.x des SDK war die Plugin-Bibliothek als direkter Quellcode enthalten, ab Version 2.x sieht es jedoch so aus, als ob Implementation'com.theta360: Plugin-Bibliothek: 2.1.0' in app / build.gradle. Es wird in Form von "import com.theta360.pluginlibrary.activity.PluginActivity" für Code wie MainActivity.java eingerichtet.

(↓ Im Fall von Version 1.0.2 wurde die Theta-Plugin-Bibliothek als Code eingefügt (Plugin-Bibliothek).)

In Theta-Plugin-Bibliothek wird die Implementierung implementiert, die den für das Plug-In spezifischen Spezifikationen entspricht. Wenn Sie Ihr eigenes Plug-In erstellen möchten, entwickeln Sie hauptsächlich den Teil App und gegebenenfalls das [Theta-Plugin] -library](https://github.com/ricohapi/theta-plugin-library) Teil kann geändert werden. Darüber hinaus können Sie mit theta-plugin-sdk ein Standbild aufnehmen, indem Sie den Auslöser von THETA V drücken.

• app

• MainActivity.java (Screenshot oben) Teil)
• Zur Hauptaktivität, die [PluginActivity] erbt (https://github.com/ricohapi/theta-plugin-sdk/blob/master/pluginlibrary/src/main/java/com/theta360/pluginlibrary/activity/PluginActivity.java) Es werden nur onCreate (), onResume () und onPause () implementiert. PluginActivity wird in der Plugin-Bibliothek definiert.

--setKeyCallback wird aufgerufen und KeyCallback-Schnittstelle ) Wurde implementiert. - onKeyDown()

• Wenn es sich um einen Auslöser (KEYCODE_CAMERA) handelte, erbte er AsyncTask TakePictureTask -plugin-sdk / blob / master / app / src / main / java / com / theta360 / pluginapplication / task / TakePictureTask.java) wird aufgerufen. Adressieren Sie in doInBackground () von TakePictureTask camera.takePicture an localhost ("127.0.0.1:8080"). .html) Web-API wird aufgerufen. --WebAPI ist WebAPI für THETA und Googles [Open Spherical Camera API](https: // Entwickler). Es ist eine Erweiterung von google.com/streetview/open-spherical-camera/reference/).
• HttpConnector, der auch in der App für Web-API-Aufrufe implementiert ist Die Klasse pluginapplication / network / HttpConnector.java wird verwendet. Diese Klasse implementiert auch andere Befehle als takePicture, die Sie verwenden können, wenn Sie die Web-API aufrufen müssen. - onKeyUp() --NotificationLedBlink wird aufgerufen, wenn Sie eine Taste drücken (zurückgeben).
• Es wird implementiert, um LED3 (Wireless Light) mithilfe von notificationLedBlink blau zu blinken. - onKeyLongPress()
• Insbesondere nicht implementiert. Der Code, der dem langen Drücken der Modustaste entspricht, ist in der Plugin-Bibliothek implementiert.

• theta-plugin-library (pluginlibrary) --Die Plugin-Bibliothek definiert THETAs eigene Sendungen, die in Dokumentation beschrieben sind.

• PluginActivity ist [AppCompatActivity]( Es erbt https://developer.android.com/reference/android/support/v7/app/AppCompatActivity) und ist eine Android-App Activity Lifecycle. Der Teil Aktivitäten / Aktivitätslebenszyklus (onCreate, onResume, onPause) ist implementiert. Die folgende Abbildung stammt von developer.android.com![(Developer.android.com) [https://developer.android.com/guide/components/activities/activity-lifecycle]](https: / /developer.android.com/guide/components/images/activity_lifecycle.png) - onCreate() --UncaughtException-Klasse, die den [UncaughtExceptionHandler] von Android (https://developer.android.com/reference/java/lang/Thread.UncaughtExceptionHandler) erbt, wird registriert. Wenn eine Ausnahme auftritt, tritt ein Fehler auf. Das Plug-In soll enden. - onResume()
• Das Schlüsselereignis wurde registriert. Die Klasse KeyReceiver wurde in pluginlibrary implementiert Wird verwendet und der Teil, der die Broadcast-Absicht erhält, wie in Empfangen von Schaltflächenereignissen in dieser Klasse beschrieben Es ist implementiert. Der onKeyReceiver wird in der PluginActivity-Klasse definiert, und die in der MainActivity der App verwendeten Rückrufe wie onKeyLongPress erfolgen über den onKeyReceiver. - onPause()
• Abhängig von der Einstellung isClosed wird der Beendigungsprozess aufgerufen.
• Registrieren Sie die KeyReceiver-Klasse ab. Wichtige Ereignisse (Rückrufe) werden nach onPause nicht mehr angezeigt.
• Außerdem in der Klasse PluginActivity Die folgenden Methoden sind definiert. Viele der in Broadcast Intent beschriebenen Steuerelemente sind in Methodenaufrufen verfügbar.
• Methoden, die WLAN steuern, wie BenachrichtigungWlanOff
• Methoden zur Steuerung von LEDs wie notificationLedShow
• Methoden, die Sounds steuern, wie BenachrichtigungAudioShutter
• Erforderliche Methoden bei Verwendung der Kamera-API, z. B. notificationCameraOpen

Wenn Sie ein vorhandenes Android-Anwendungsprojekt in ein Plug-In verwandeln, können Sie es verwenden, indem Sie die erforderlichen Teile wie die Plugin-Bibliothek von theta-plugin-sdk in das Projekt importieren oder kopieren.

3. Bewegen und sehen Sie mit dem Smartphone oder THETA V.

Bewegen Sie es auf Ihrem Android-Smartphone oder THETA V, um es zu sehen. Da mein Smartphone Android 7.0 ist, musste ich minSdkVersion und targetSdkVersion auf API24 ändern. Ich habe die Plugin SDK-App auf meinem Android-Smartphone ausgeführt und gesehen. Hello World wird angezeigt (obwohl Theta keinen Bildschirm haben sollte). Auf die gleiche Weise können Sie auch Android-Apps auf THETA ausführen. Sie können Vysor verwenden, um den Bildschirm von THETA anzuzeigen.

4. Zusammenfassung

Die Plug-In-Entwicklung kann mit Android Studio genauso durchgeführt werden wie die normale Entwicklung von Android-Apps. Klassen, die die für THETA V-Plug-Ins spezifischen Funktionen implementieren, sind in theta-plugin-sdk definiert. Mithilfe der Klasse PluginActivity Steuert die Klasse THETA, HttpConnector Sie können die in Web API definierten Funktionen verwenden.

Referenz

• RICOH THETA Plugin Development Workshop # 1 Material