Passa ai contenuti principali

Microsoft Band SDK Preview - Notifiche

In questo post della serie dedicata all’SDK del Microsoft Band ci occuperemo delle funzioni messe a disposizione dello sviluppatore per l’invio di notifiche al device.
Nell’attuale versione dell’SDK (che ricordiamo essere la 1.3.10219), abbiamo a disposizione le seguenti tipologie di notifiche:
  • Messagge: il message è una notifica, inviata ad una tile particolare, composta da un titolo e da un testo che rimane memorizzata nel device. Il message può generare un avvertimento all’utente o meno;
  • Dialog: il dialog e’ una notifica, inviata ad una tile particolare, anch’essa composta da un titolo e da un testo ma non rimane memorizzata tra i messaggi della tile e genera sempre un avvertimento per l’utente (è un vero e proprio dialog).
Oltre alle notifiche che trasportano testo, è possibile anche far "vibrare" il device.
Tutte e funzionalità di notifiche sono esposte dall’interfaccia IBandNotificationManager. Possiamo recuperare un’istanza valida di questa interfaccia dalla proprietà NotificationManager dell’interfaccia IBandClient.

image

L’interfaccia IBandNotificationManager espone tre metodi (con opportuni overload) per gestire le notifiche.

SendMessageAsync

Il metodo SendMessageAsync permette di inviare una notifica di tipo Message ad una specifica Tile.

Try
    Await App.CurrentBandClient.NotificationManager.SendMessageAsync(TileFactory.AppTileId,
                                                                    NotificationTitleText.Text,
                                                                    NotificationBodyText.Text,
                                                                    DateTimeOffset.Now,
                                                                    Notifications.MessageFlags.ShowDialog )
Catch ex As BandException

End Try

Nell’esempio precedente App.CurrentBandClient è un’istanza valida di IBandClient e TileFactory.TileId è il Guid della tile a cui inviare la notifica.
Da notare la possibilità di definire anche un DateTimeOffset che apparirà all’utente sul Band e l’enumerazione MessageFlags indicare se deve essere visualizzato il messaggio all’utente o semplicemente accodato il messaggio a quelli presenti nella tile.
Questo tipo di notifica viene memorizzato sul Band e, in caso di messaggi non letti, viene visualizzato il badge numerico e la small tile per segnalare il numero di messaggi in attesa di lettura.

SendDialogAsync

Il metodo SendDialogAsync permette di inviare una notifica di tipo Dialog al Band.

Try
    Await App.CurrentBandClient.NotificationManager.ShowDialogAsync(TileFactory.AppTileId,
                                                                    NotificationTitleText.Text,
                                                                    NotificationBodyText.Text)
Catch ex As BandException

End Try

La notifica di tipo Dialog non viene memorizzata sul Band e viene sempre visualizzata la notifica all’utente.

SNAGHTMLa5b08cb

Sia per i Message che per i Dialog, se il guid della Tile non corrisponde ad una tile dell’app, si ottiene una eccezione di tipo BandException.

VibrateAsync

Il metodo VibrateAsync permette di inviare quello che viene chiamato “Haptics” (una vibrazione) al Band. L’invio di notifiche di tipo Message e Dialog genera automaticamente l’haptics del Band.

Try
    Await App.CurrentBandClient.NotificationManager.VibrateAsync(vibrationTypeSelected)
Catch ex As bandException

End Try

In questo caso non serve il tileid (la vibrazione viene inviata al band e non ad una tile specifica).
Il progetto completo riguardante le notifiche è 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