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

VB.NET : Aggregare stringhe con LINQ

Tip facile facile, ma a qualcuno potrebbe servire. Supponiamo di avere una lista di stringhe (magari come risultato di una query LINQ) e di voler ottenere una stringa con la concatenazione delle stesse: Dim list = CreateList() Dim concatStr = (From s In list _ Select s).Aggregate( Function (currentString, nextString) currentString + nextString) MessageBox.Show(concatStr) Il metodo CreateList non ci interessa, in questo momento, ma crea una lista di oggetti String. Protected Function CreateList() As IEnumerable( Of String ) Dim list As String () = {" stringa1 ", " stringa2 ", " stringa3 ", " stringa4 ", " stringa5 "} Return list.AsEnumerable() End Function Questo metodo potrebbe restituire una qualsiasi lista di oggetti di cui, nella select successiva recuperiamo solo stringhe. La stessa tecnica è utilizzabile per concatenare stringhe inserendovi un carattere separatore Dim list = CreateList() Dim

VB.NET: SplashScreen con effetto fade-in

In questo post vorrei proporvi un modo per realizzare una splash screen per le nostre applicazioni Windows Form che appare progressivamente con un effetto fade. Supponiamo di avere il nostro progetto VB.NET in una soluzione Visual Studio 2008 in cui abbiamo il sorgente della nostra applicazione Windows Form. Inseriamo una splash screen utilizzando il menù Progetto->Aggiungi Nuovo Elemento e selezionando il tipo di elemento “Schermata Iniziale” A questo punto Visual Studio creerà, automaticamente, la schermata iniziale che possiamo personalizzare graficamente come vogliamo. Per poter fare in modo che questa finestra appaia nel momento in cui avviamo l’applicazione, è necessario aprire le proprietà del progetto e impostare la maschera di avvio: In questo modo, all’avvio dell’applicazione, la schermata appare immediatamente e scompare un attimo prima della visualizzazione della finestra dell’applicazione. Possiamo far apparire la schermata iniziale con un ef

VB.NET: Convertire un file DOC in RTF e PDF con office interop

In questo post vorrei proporvi del codice per poter convertire un file .doc in un file .rtf oppure .pdf utilizzando le API di interoperabilità di Office. Creeremo una classe, DocConverter, che esporrà le due funzionalità sopra citate. Cominciamo con il prevedere un attributo privato della classe che rappresenterà l’applicazione Word che utilizzeremo per la conversione. Creeremo l’istanza dell’attributo privato all’interno del costruttore della classe: Public Sub New () If Not CreateWordApp() Then Throw New ApplicationException(" Assembly di interoperabilità con Office non trovato! ") End If End Sub Private _wordApp As Word.ApplicationClass Protected Function CreateWordApp() As Boolean Dim retval = True Try _wordApp = New Word.ApplicationClass() _wordApp.Visible = False Catch ex As System.Exception _wordApp = Nothing retval = False End Try Return retval End Function La conve