[JAVA] Développement de plug-in THETA (à propos de theta-plugin-sdk)
Vérifiez le contenu du SDK pour le développement du plug-in THETA (theta-plugin-sdk) publié sur github.
Mise à jour le 24 janvier 2020: mise à jour pour correspondre au dernier SDK (SDK ver.1.0.2-> ver.2.1.0). Correction des liens brisés.
1.Tout d'abord
RICOH THETA V est fait d'Android OS et ne prenait pas initialement en charge les plug-ins, mais [RICOH THETA V] fin juin Plugin Partner Program Start](https://theta360.com/ja/info/news/2018-06-28-01/) vous permet d'installer votre propre application Android (= plugin). Consultez le SDK et la documentation ici.
- SDK : https://github.com/ricohapi/theta-plugin-sdk
- Document: https://api.ricoh/docs/theta-plugin/how-to-develop/
Pour installer le plug-in développé sur le corps principal de THETA via la commande adb, il est nécessaire de s'inscrire en tant que développeur de THETA Plugin (une photo de la machine THETA V ou Z1 est requise). Le site se trouve sur RICOH Developer Connection, mais l'enregistrement des développeurs de plug-ins n'a rien à voir avec "Compte RICOH", vous n'avez donc pas besoin de créer un compte RICOH.
- Enregistrement du développeur du plug-in: Programme de partenariat du plug-in RICOH THETA
- Gestion de compte enregistré: RICOH THETA Plug-in Partner Program (Profile)
- Enregistrez le plug-in développé: RICOH THETA Plug-in Partner Program (Partner Menu)
2. Contenu de theta-plugin-sdk
Ouvrez theta-plugin-sdk (ver.2.1.0) cloné à partir de github dans Android Studio.
En regardant le code source, il est divisé en deux parties, une application et une bibliothèque de plugins. Dans app, des classes telles que network sont implémentées. Jusqu'à la ver.1.x du SDK, la bibliothèque de plugins était incluse en tant que code source direct, mais à partir de la ver.2.x, elle ressemble à ʻimplementation'com.theta360: pluginlibrary: 2.1.0'dans app / build.gradle. Il est configuré sous la forme de ʻimport com.theta360.pluginlibrary.activity.PluginActivity;sur du code tel que MainActivity.java.
(↓ Dans le cas de la version 1.0.2, theta-plugin-library a été inclus en tant que code (bibliothèque de plugins).)
Dans theta-plugin-library, l'implémentation correspondant aux spécifications spécifiques au plug-in est implémentée. Si vous souhaitez créer votre propre plug-in, développez principalement la partie app, et si nécessaire, theta-plugin -library peut être modifiée. De plus, theta-plugin-sdk vous permet de prendre une image fixe en appuyant sur le déclencheur de THETA V.
- app
- MainActivity.java (Capture d'écran ci-dessus partie) -À MainActivity qui hérite de PluginActivity Seuls onCreate (), onResume () et onPause () sont implémentés. PluginActivity est défini dans la bibliothèque de plugins.
- Implémentation dans onCreate () --setKeyCallback est appelé et KeyCallback interface A été mis en place. - onKeyDown() --Quand c'était un bouton de l'obturateur (KEYCODE_CAMERA), il a hérité de AsyncTask TakePictureTask -plugin-sdk / blob / master / app / src / main / java / com / theta360 / pluginapplication / task / TakePictureTask.java) est appelé. Dans doInBackground () de TakePictureTask, adressez camera.takePicture à localhost ("127.0.0.1:8080") .html) L'API Web est appelée. --WebAPI est WebAPI pour THETA et [Open Spherical Camera API] de Google (https: // développeurs. Il s'agit d'une extension de google.com/streetview/open-spherical-camera/reference/).
- HttpConnector qui est également implémenté dans l'application pour les appels d'API Web pluginapplication / network / HttpConnector.java) est utilisée. Cette classe implémente également des commandes autres que takePicture, que vous pouvez utiliser lorsque vous devez appeler l'API Web. - onKeyUp() --NotificationLedBlink est appelé lorsque vous appuyez (retournez) sur un bouton. --Il est implémenté pour faire clignoter LED3 (Wireless Light) en bleu en utilisant notificationLedBlink. - onKeyLongPress()
- Non mis en œuvre en particulier. Le code correspondant à la pression longue sur le bouton de mode est implémenté dans la bibliothèque de plugins.
- La bibliothèque de plugins définit les propres diffusions de THETA, etc. décrites dans Documentation.
- PluginActivity est [AppCompatActivity]( Il hérite de https://developer.android.com/reference/android/support/v7/app/AppCompatActivity) et est une application Android [Activity Lifecycle](https://developer.android.com/guide/components/ La partie activités / cycle de vie de l'activité (onCreate, onResume, onPause) est implémentée.
La figure suivante est tirée de 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() La classe --UncaughtException qui hérite d'Android UncaughtExceptionHandler est enregistrée, et si une exception se produit, une erreur se produit. Le plug-in est censé se terminer. - onResume() - L'événement clé a été enregistré. KeyReceiver classe implémentée dans pluginlibrary Est utilisé, et la partie qui obtient l'intention de diffusion comme décrit dans Réception des événements du bouton dans cette classe Il est mis en œuvre. OnKeyReceiver est défini dans la classe PluginActivity et les rappels tels que onKeyLongPress utilisés dans la mainActivity de l'application sont effectués via le onKeyReceiver. - onPause()
- En fonction du paramètre isClosed, le processus de terminaison est appelé.
- Désinscrivez la classe KeyReceiver. Les événements clés (rappels) ne surviendront pas après onPause. --En outre, dans la classe PluginActivity Les méthodes suivantes sont définies. De nombreux contrôles décrits dans Broadcast Intent sont disponibles dans les appels de méthode.
- Méthodes qui contrôlent le WLAN, telles que notificationWlanOff --Méthodes de contrôle des LED telles que notificationLedShow
- Méthodes qui contrôlent les sons tels que notificationAudioShutter
- Méthodes requises lors de l'utilisation de Camera API telles que notificationCameraOpen
Lorsque vous transformez un projet d'application Android existant en un plug-in, vous pouvez l'utiliser en important ou en copiant les parties nécessaires telles que la bibliothèque de plugins de theta-plugin-sdk vers le projet.
3. Déplacez-vous et voyez avec un smartphone ou THETA V
Déplacez-le sur votre smartphone Android ou THETA V pour le voir. Étant donné que mon smartphone est Android 7.0, j'ai dû changer minSdkVersion et targetSdkVersion en API24.
J'ai exécuté l'application Plugin SDK sur mon smartphone Android. Hello World s'affiche (bien que Theta ne devrait pas avoir d'écran). Vous pouvez également exécuter des applications Android sur THETA de la même manière. Vous pouvez utiliser Vysor pour afficher l'écran de THETA.
4. Résumé
Le développement de plug-ins peut être effectué à l'aide d'Android Studio de la même manière que le développement d'applications Android normales. Les classes qui implémentent les fonctions spécifiques aux plug-ins THETA V sont définies dans theta-plugin-sdk. En utilisant la classe PluginActivity Contrôle THETA, classe HttpConnector Vous pouvez utiliser les fonctions définies dans API Web.
référence
Recommended Posts