Passa ai contenuti principali

Microsoft Band SDK Preview - Personalizzazione

In questo post prenderemo in esame l’ultima serie di API attualmente disponibile per sviluppare con Microsoft Band ed in particolare le API relative alla personalizzazione del device.
Come già visto nei precedenti post della serie, tutte le API sono esposte dall’interfaccia IBandClient e, in particolare, da 4 proprietà esposte dalla stessa.
Nel caso della personalizzazione, la proprietà che funge da gateway per le API è la PersonalizationManager, di tipo IBandPersonalizationManager.

image

Possiamo suddividere le funzionalità di gestione della personalizzazione in due macro aree: gestione dell’immagine della “Me Tile” e gestione del tema.

Me Tile

La “Me Tile” è la finestra principale del Band, quella che mostra l'orario e uno a scelta (dell’utente) tra battito cardiaco, passi fatti, calorie bruciate o distanza percorsa.

image

E’ possibile personalizzare, al momento, lo sfondo della “Me Tile” utilizzando un’immagine 310x102 pixel.
L’interfaccia IBandPersonalizationManager mette a disposizione due metodi per la gestione di tale immagine:
  • GetMeTileImageAsync: permette di recuperare l’immagine corrente della “Me Tile”. Il valore restituito, se il Band è correttamente connesso, è un’istanza della classe BandImage;
  • SetMeTileImageAsync: consente di impostare l’immagine della “Me Tile”.

Entrambi i metodi lavorano su istanze della BandImage e l’SDK mette a disposizione dei metodi di estensione per convertire WriteableBitmap in BandImage e viceversa.

image

Nel seguente pezzo di codice possiamo vedere come recuperare l’immagine della “Me Tile”

Try
     Await App.CurrentBandClient.PersonalizationManager.SetMeTileImageAsync(wBitmap.ToBandImage())
 Catch ex As BandException

 End Try

Nel precedente esempio, App.CurrentBandClient è un’istanza valida di BandClient (come visto nei precedenti post) e wBitmap è la bitmap che vogliamo utilizzare.
In maniera analoga, per recuperare l’immagine corrente della “Me Tile” possiamo scrivere:

Try
     Dim bandImage = Await App.CurrentBandClient.PersonalizationManager.GetMeTileImageAsync()
Catch ex As BandException

End Try

Theme

L’altra macro area a cui possiamo accedere è quella della personalizzazione dei colori utilizzati dal Band: il tema.
Il tema del Band è composto da sei colori, il cui significato e nome è illustrato nella seguente immagine:

image

L’interfaccia IBandPersonalizationManager ci mette a disposizione due metodi (con relativi overload) per poter gestire il tema:
  • GetThemeAsync: consente di recuperare il tema corrente del Band. Il risultato è un’istanza della classe BandTheme;
  • SetThemeAsync: consente di impostare il tema del Band.

La classe BandTheme espone i sei colori illustrati nella precedente immagine come proprietà di tipo BandColor.
image

Come già visto in un precedente post della serie, abbiamo a disposizione degli extension method per poter convertire un oggetto di tipo Windows.UI.Color in BandColor e viceversa.
Il seguente pezzo di codice mostra come impostare un tema per il band:

Try
    Dim tema = New BandTheme()
    tema.Base = Colors.LightBlue.ToBandColor()
    tema.HighContrast = Colors.Blue.ToBandColor()
    tema.Highlight = Colors.BlueViolet.ToBandColor()
    tema.Lowlight = Colors.LightCyan.ToBandColor()
    tema.Muted = Colors.DarkBlue.ToBandColor()
    tema.SecondaryText = Colors.White.ToBandColor()

    Await App.CurrentBandClient.PersonalizationManager.SetThemeAsync(tema)
Catch ex As BandException

End Try

Con questo post termina la prima mini serie dedicata all’SDK del Band.

L’esempio completo utilizzato in questo post è scaricabile al seguente link.


Commenti

Post popolari in questo blog

MVP Reconnect …… ovvero quando entri nella “famigghia” resti sempre nella “famigghia”!!!

Ma di che “famigghia” stiamo parlando!!!!

Fermi tutti, non si tratta di robe strane o sette segrete o affari malavitosi….stiamo parlando della grande famiglia dei Microsoft MVP.

Per chi non sapesse cosa sono i Microsoft MVP, vi consiglio di fare un giro sul sito ufficiale del programma (link), ma, volendolo spiegare in pochisime parole, si tratta di un riconoscimento che Microsoft da a persone che si distinguono per il loro impegno, aiutando gli altri ad ottenere il massimo grazie alle tecnologie Microsoft. Si tratta di persone, non dipendenti Microsoft, che mettono la loro passione, il loro tempo, la loro buona volontà per la divulgazione e la condivisione della conoscenza. Non necessariamente (come qualcuno erroneamente sostiene, evidentemente non conoscendo le basi del programma) si tratta di professionisti nel termine letterale del termine ma si tratta comunque di un gruppo di persone che sacrifica un pò del suo tempo (e, a volte, vi assicuro neanche pò!!!) per la sua passione.

Pe…

Nuova versione del Band SDK

E’ di ieri l’annuncio del rilascio della nuova versione dell’SDK per il Microsoft Band.
Si tratta della versione 1.3.10417 (la precedente e, prima della serie, era la 1.3.10219 preview).
Maggiori informazioni, download dell’SDK per le tre piattaforme Windows Phone, iOS e Android all’indirizzo http://developer.microsoftband.com/.
Allo stesso indirizzo potrete trovare anche la documentazione.
Nei mesi scorsi mi sono gia’ occupato della precedente versione e questi sono i post che ne parlano:
Microsoft Band SDK Preview - First LookMicrosoft Band SDK Preview - ”Hello Band”Microsoft Band SDK Preview - Accesso ai sensoriMicrosoft Band SDK Preview - TileMicrosoft Band SDK Preview - NotificheMicrosoft Band SDK Preview - Personalizzazione
Gli argomenti trattati e il codice proposto dovrebbe, ad una prima lettura delle nuove funzionalita’ inserite, essere ancora valido e funzionante ma nei prossimi giorni prendero’ in esame tutti gli argomenti dei precedenti post e vedremo cosa cambia e cosa e’ …

Template di progetto per sviluppare applicazioni WPF con Intel® RealSense™

E’ disponibile, nella gallery di Visual Studio, la prima versione del mio template di progetto per applicazioni WPF scritte in C# che permette di realizzare applicazioni con l’SDK di Intel® RealSense™.Il template si può scaricare direttamente all’interno Visual Studio utilizzando il tool “Extensions and Updates”oppure all’indirizzo https://visualstudiogallery.msdn.microsoft.com/1c36ecfd-8c00-4aee-b20c-a1726ab6424dIl template esegue le seguenti operazioni per voi:Aggiunge la reference all’assembly libpxcclr.cs.dll (nelle due distinte versioni per x86 e x64);Aggiunge lo script di post build per copiare la libreria libpxccpp2c.dll dalla cartella dell’SDK alla cartella bin del vostro progetto.Una volta creato il progetto dovete rimuovere la configurazione di compilazione AnyCPU (che non ha più senso) dalla vostra solution e sarete pronti per sviluppare con Intel® RealSense™.Ovviamente dovete installare l’SDK che potete scaricare all’indirizzo https://software.intel.com/en-us/intel-realsen…