Sintesi
Il RealWear Arc 3 utilizza un display micro-OLED see-through a colori, posizionato per l'occhio destro, oltre a un touchpad capacitivo integrato e ad Ari OS, basato su Android 13. Gli sviluppatori possono partire da un'app Android e adattarne la schermata per un uso conciso, ad alto contrasto e a mani libere. Il servizio vocale WearHF di RealWear è già integrato nel dispositivo, quindi la navigazione vocale di base non richiede un SDK separato. Il principale cambiamento progettuale rispetto al Navigator 520 consiste nel pianificare una visualizzazione trasparente e fissa per l'occhio destro, anziché un display opaco su un braccio regolabile. Testa l'app su un Arc 3 reale prima della distribuzione. [1][2][3]
Introduzione
Sviluppare per il RealWear Arc 3 non significa semplicemente rimpicciolire lo schermo di uno smartphone. Il display see-through dell'Arc 3 lascia visibile l'ambiente circostante, è destinato solo all'occhio destro e il lavoro è pensato per svolgersi a mani libere. Un'app utile ha quindi bisogno di schermate brevi, controlli chiari e comandi vocali che abbiano senso mentre una persona sta lavorando.
Questa guida segue un piccolo esempio: un tecnico apre una semplice schermata di ispezione, legge un controllo, quindi sceglie “MARK PASS” o “REPORT ISSUE”. È il tuo team a definire l'attività effettiva e la terminologia a partire dalle proprie istruzioni di lavoro; l'Arc 3 non crea quel processo al posto tuo. I passaggi seguenti mostrano da dove iniziare, quale software aprire, dove si trova il codice della schermata e come testarlo sul visore.
Sviluppare e testare la tua app per Arc 3 passo dopo passo
Per chi non è sviluppatore: i passaggi da 3 a 6 riguardano file e codice di app Android. Se non sviluppi app, chiedi al tuo sviluppatore Android di completarli; i passaggi 1-2 e 7-10 mostrano da dove parte il team e come testa l'app e la porta in fase pilota.
Passaggio 1. Apri la pagina di download di Android Studio
Inizia dal computer di sviluppo. Android Studio è il programma usato per creare, modificare ed eseguire l'app Android di esempio.
1. Apri un browser sul computer. Vai su developer.android.com/studio, la pagina di download ufficiale di Android Studio di Google.
2. Scarica e installa Android Studio. Scegli la versione adatta al tuo computer e segui le istruzioni del programma di installazione.
3. Apri Android Studio dopo l'installazione. Lascialo aperto: nel passaggio 3 userai la sua schermata di benvenuto (Welcome) per creare il progetto di esempio.
Passaggio 2. Apri il sito per sviluppatori di RealWear
Usa un browser sullo stesso computer per consultare le indicazioni di RealWear prima di creare l'app. Così vedrai cosa funziona su Arc 3 e come si usano i suoi comandi vocali integrati.
1. Apri una nuova scheda del browser. Vai su developer.ari-os.com, il sito della documentazione per sviluppatori di RealWear Ari OS.
2. Nel menu di navigazione a sinistra, apri “AR Device” e poi “Basics” o “Get Started”. Le etichette del portale possono cambiare, quindi, se la dicitura è diversa, cerca la sezione dedicata alle nozioni di base.
3. Apri “Android Development” e “User Experience Guidelines”. Queste pagine spiegano come adattare un'app Android per RealWear e mantenerla leggibile nell'uso a mani libere.
4. Apri anche la pagina “Enabling Developer Tools”. Userai queste istruzioni nel passaggio 8 per collegare il visore per i test.
Passaggio 3. Crea l'app Android di esempio
Torna ad Android Studio sul computer. Crea una piccola app di esempio, in modo che nei passaggi successivi tu abbia un progetto reale, un file della schermata e una posizione per il codice.
1. Nella schermata di benvenuto, seleziona “New Project”. Scegli “Empty Views Activity”, se è presente nell'elenco. Questo modello crea una semplice schermata Android che utilizza un file di layout XML.
2. Assegna al progetto il nome “ArcInspectionDemo”. Seleziona Kotlin come linguaggio, quindi premi “Finish”.
3. Attendi che Android Studio finisca di caricare il progetto. Tieni aperto il progetto. Nel passaggio 4 aggiungerai il messaggio e i pulsanti al suo file della schermata.
Passaggio 4. Apri il file della schermata e aggiungi il messaggio e i pulsanti
In Android Studio, aggiungi la schermata di ispezione visibile al file di layout XML. XML è il formato di testo che questo modello Android usa per descrivere gli elementi della schermata.
1. Nel pannello Project a sinistra, apri il relativo menu di visualizzazione e seleziona “Project”. Il menu di visualizzazione si trova nella parte superiore del pannello Project. In questo modo viene mostrato il percorso completo delle cartelle.
2. Apri app > src > main > res > layout. È la cartella che contiene il layout della schermata dell'app di esempio.
3. Apri “activity_main.xml”. Sostituiscine il contenuto con l'esempio qui sotto, che crea un messaggio, una riga di stato e due pulsanti grandi.
4. Salva il file. In Android Studio, scegli File > Save oppure premi Ctrl+S su Windows/Linux o Cmd+S su macOS.
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" android:padding="24dp">
<TextView android:id="@+id/statusText" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="Pump 04: Check pressure" android:textSize="24sp" />
<Button android:id="@+id/passButton" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="MARK PASS" android:contentDescription="hf_commands:Mark Pass" />
<Button android:id="@+id/reportButton" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="REPORT ISSUE" android:contentDescription="hf_commands:Report Issue" /> </LinearLayout>
Per adattarlo al tuo design: questo file di layout XML è il progetto della schermata dell'app. Modifica le parole all'interno di “android:text=…” per mostrare la tua attività e le etichette dei tuoi pulsanti, e modifica “android:contentDescription” dopo “hf_commands:…” per impostare le parole che gli operatori pronunciano per usare ciascun pulsante. Il design è controllato da impostazioni come “android:orientation=…” (come sono disposti gli elementi), “android:padding=…” (lo spazio intorno a essi) e “android:textSize=…” (la dimensione del testo). Non modificare i nomi “android:id=…”, perché il codice Kotlin li usa per collegare gli elementi della schermata alle rispettive azioni.
Passaggio 5. Aggiungi un'azione a ciascun pulsante
Continua a usare Android Studio, ma apri il file Kotlin che gestisce la schermata. Questo file indica all'app di esempio cosa fare dopo che l'operatore ha scelto MARK PASS o REPORT ISSUE.
1. Nel pannello Project, apri app > src > main > java. Apri la cartella con il nome del tuo progetto, quindi apri “MainActivity.kt”. Se nella parte superiore del pannello vedi “Android” anziché “Project”, imposta prima il menu di visualizzazione su “Project”.
2. Mantieni la riga package in cima a MainActivity.kt. Sostituisci il codice sotto quella riga con l'esempio mostrato di seguito. La riga package è stata creata da Android Studio per il tuo progetto.
3. Salva MainActivity.kt. L'esempio cambia il messaggio sullo schermo quando si seleziona uno dei due pulsanti. In un progetto reale, il tuo sviluppatore può collegare i pulsanti al sistema di salvataggio o di reporting dell'azienda.
import android.os.Bundle import android.widget.Button import android.widget.TextView import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main)
val status = findViewById<TextView>(R.id.statusText) findViewById<Button>(R.id.passButton).setOnClickListener { status.text = "Inspection marked PASS" } findViewById<Button>(R.id.reportButton).setOnClickListener { status.text = "Issue report started" } } }
L'esempio mostra una breve conferma sullo schermo. Non invia né memorizza i dati dell'ispezione: un'app di produzione richiede un collegamento proprio dell'azienda per il salvataggio o il reporting.
Quali parti puoi modificare: le parole all'interno di status.text = "Inspection marked PASS" e status.text = "Issue report started" sono i messaggi di conferma mostrati sullo schermo, quindi puoi sostituirle con messaggi adatti alla tua attività. Le righe che contengono passButton, reportButton e statusText collegano questo codice Kotlin ai pulsanti e all'area di testo nel layout XML, quindi mantieni invariati quei nomi, a meno che non li modifichi anche nel file di layout.
Passaggio 6. Rendi la schermata facile da leggere su Arc 3
Torna ad activity_main.xml in Android Studio. Mantieni la schermata essenziale, perché Arc 3 mostra i contenuti in un display see-through posizionato per l'occhio destro.
1. Apri di nuovo app > src > main > res > layout > activity_main.xml. È lo stesso file della schermata del passaggio 4.
2. Mantieni un'unica istruzione e due azioni chiare. Usa nomi brevi per i pulsanti e frasi vocali ben distinguibili tra loro.
3. Mantieni testo e pulsanti grandi e facili da trovare. Usa il dimensionamento flessibile di Android, in modo che gli elementi si adattino al display invece di fissarne la posizione su pixel specifici.
4. Salva il file con Ctrl+S su Windows/Linux o Cmd+S su Mac. Collegherai l'Arc 3 e controllerai la schermata aggiornata nei passaggi 8 e 9.
Passaggio 7. Prepara i controlli del touchpad
Arc 3 include un touchpad capacitivo. Gli stessi pulsanti dovrebbero funzionare con la normale selezione Android, ma verifica le esatte azioni del touchpad sul visore prima di farvi affidamento.
1. Resta in activity_main.xml. Mantieni MARK PASS e REPORT ISSUE come normali pulsanti Android, in modo che l'app possa ricevere le relative azioni di selezione standard.
2. Non dare per scontato un particolare gesto di scorrimento o di tocco. RealWear indica la presenza di un touchpad, ma non pubblica una mappa completa dei gesti per sviluppatori valida per ogni app.
3. Salva il file della schermata. Testerai l'input del touchpad sul visore fisico nel passaggio 9.
Passaggio 8. Collega Arc 3 e attiva l'accesso sviluppatore
Passa al visore e al computer. Android Studio ha bisogno dell'autorizzazione per installare una copia di prova della tua app su Arc 3.
1. Collega Arc 3 al computer con un cavo USB-C. Lascialo collegato.
2. (Facoltativo) Sul computer, apri Vysor, lo strumento di mirroring desktop consigliato da RealWear. Il mirroring è facoltativo: ad Android Studio servono solo il collegamento USB e l'impostazione di debug USB del passaggio successivo.
3. Sul visore, attiva le opzioni sviluppatore e il debug USB. RealWear afferma che i suoi dispositivi vengono forniti con ADB attivato ma con gli strumenti per sviluppatori disattivati. Pronuncia MY SETTINGS, poi ADVANCED SETTINGS, poi ABOUT DEVICE; pronuncia PAGE DOWN finché non è visibile Build Number, quindi pronuncia BUILD NUMBER circa sette volte, finché il dispositivo non mostra “You are now a developer!”. Pronuncia NAVIGATE BACK, poi SYSTEM, poi DEVELOPER OPTIONS, e attiva il debug USB. Quando Arc 3 chiede se consentire il debug USB, scegli “Allow”.
4. Torna ad Android Studio. L'Arc 3 collegato dovrebbe ora essere disponibile come dispositivo per i test.
Passaggio 9. Esegui e testa l'app su Arc 3
Usa Android Studio per installare l'app di esempio, quindi controlla la schermata, i comandi vocali e il touchpad indossando il visore.
1. In Android Studio, apri l'elenco dei dispositivi nella barra degli strumenti superiore. Scegli l'Arc 3 collegato; potrebbe comparire come modello A31G.
2. Seleziona “Run” nella barra degli strumenti. Android Studio installa e apre l'app sul visore. Se Arc 3 non compare, controlla il cavo, l'impostazione sviluppatore e l'autorizzazione al debug USB.
3. Indossa Arc 3 e controlla la schermata. Verifica che il messaggio sia leggibile nel display per l'occhio destro, con l'area di lavoro e l'illuminazione reali sullo sfondo.
4. Pronuncia “Mark Pass”, poi “Report Issue”. Verifica che ogni volta il messaggio cambi nella conferma corrispondente.
5. Testa il touchpad separatamente. Verifica di poter selezionare ciascun pulsante come previsto. Se qualcosa è difficile da vedere o da usare, torna ad Android Studio e modifica gli stessi file.
Passaggio 10. Scegli come distribuire l'app
Dopo che il prototipo ha superato il test sul dispositivo, coordinati con il tuo team IT prima di installarlo per un progetto pilota o una distribuzione più ampia.
1. Per un progetto pilota con un piccolo team, chiedi all'IT di installare l'APK di prova. Usa il processo di gestione delle app approvato dall'azienda.
2. Per la pubblicazione sul marketplace o il supporto agli sviluppatori, apri la pagina del RealWear Developer Program. Verifica i requisiti attuali di adesione e pubblicazione; l'adesione è facoltativa per i test privati.
3. Verifica la compatibilità prima di una distribuzione più ampia. Un'installazione di prova riuscita non equivale all'approvazione per il marketplace né a una certificazione formale. Ricontrolla le indicazioni di RealWear e le dipendenze della tua app prima della distribuzione. [6]
Verifiche di design prima del rilascio
· Limita l'attività principale a un numero ridotto di controlli selezionabili con la voce. RealWear avverte che le schermate dense, pensate per l'uso touch, possono essere difficili da usare a mani libere.
· Usa etichette chiare che un operatore possa pronunciare in modo naturale. Evita comandi dal suono simile e, dove possibile, mostra il testo del comando.
· Testa dimensione del testo, colori e contrasto direttamente sull'Arc 3. La sua visione ottica see-through colloca sfondi reali dietro i contenuti digitali.
· Mantieni l'azione principale facile da trovare nella visualizzazione fissa per l'occhio destro. Non dare per scontato che un layout pensato per il braccio del Navigator si allinei nella stessa posizione.
· Non dipendere da Google Play Services o ARCore senza verificarne il supporto. RealWear afferma che i suoi dispositivi basati su Android non includono Google Services e la sua pagina di supporto indica che ARCore non è supportato.
· Usa un visore reale per le verifiche finali. L'emulatore può testare la logica di base dell'app, ma non può riprodurre il touchpad, il controllo vocale, l'adattamento all'occhio destro né lo sfondo see-through dell'Arc 3.
Conclusione
Sviluppare per il RealWear Arc 3 significa adattare un'app Android a un display compatto, see-through e per l'occhio destro, oltre che a un uso a mani libere. Parti da un'attività lavorativa chiara, usa controlli leggibili, aggiungi comandi WearHF dove sono utili e testa l'input vocale e del touchpad su un visore fisico. Rispetto al display a braccio del Navigator 520, la trasparenza dell'Arc 3, la posizione fissa per l'occhio destro e il touchpad capacitivo richiedono un layout diverso e verifiche sul dispositivo. Per le aziende, questo approccio può rendere le istruzioni di lavoro più facili da consultare mentre gli operatori restano consapevoli dell'ambiente circostante, e un breve progetto pilota aiuta a individuare problemi di usabilità o compatibilità prima di una distribuzione più ampia.
