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: 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:PublicSubNew()
IfNot CreateWordApp() Then
ThrowNew ApplicationException("Assembly di interoperabilità con Office non trovato!")
EndIf
EndSub
Private _wordApp As Word.ApplicationClass
ProtectedFunction CreateWordApp() AsBoolean
Dim retval = True
Try
_wordApp = New Word.ApplicationClass()
_wordApp.Visible = False
Catch ex As System.Exception
_wordApp = Nothing
retval = False
EndTry
Return retval
EndFunction

La conversione del file doc sarà effettuata aprendo il file stesso ed eseguendo un’operazione di SaveAs:

Pr…

Creare uno shortcut con VB.NET

Prendendo spunto da un post comparso sul forum MSDN vorrei proporvi un tip su come creare uno shortcut utilizzando VB.NET.Per poter creare uno shortcut possiamo procedere in due modi: o ci studiamo la struttura del file .lnk e scriviamo una classe che è in grado di ricreare tale struttura oppure utilizziamo Windows Scripting Host.La prima soluzione è percorribile ma laboriosa perchè la struttura di un file lnk non è banale. Chi fosse interessato a vedere come è composto, internamente, un file lnk può scaricare la seguente reference guide (link).Io vorrei proporvi la seconda strada e realizzerò una classe che incapsula l’utilizzo di Windows Scripting Host.L’object model di Windows Scripting Host è contenuto nella dll IWshRuntimeLibrary che può essere referenziata, nel nostro progetto, utilizzando il tab COM della finestra di aggiunta delle reference:Tra gli oggetti che troviamo all’interno della libreria utilizzeremo la classe WshShell e la classe WshShortcut.La prima delle due rappres…

Cambiare la lingua di Visual Studio 2008

Oggi ho avuto qualche problema installando Windows Mobile 6 Professional SDK Refresh e Windows Mobile 6 Standard SDK Refresh.Scaricati i file di installazione e installati, ho provato a creare un progetto di tipo Windows Mobile 6.0 e mi sono beccato questo errore:Dopo qualche smanettamento abbiamo scoperto (e ringrazio il mitico Matteo per l’aiuto) che il mio Visual Studio 2008, pur essendo in Inglese (prova ne era il fatto che gli hotfix e la SP installata erano nella lingua di Albione) aveva come lingua impostata quella del sistema operativo (italiano).Ovviamente, non avrebbe mai potuto trovare la cartella 1040 (italiano) visto che l’installazione dell’SDK aveva supposto che la lingua del Visual Studio fosse Inglese (1033).La soluzione del problema è duplice:1) Duplicate la cartella 1033 presente nel percorso evidenziato dall’errore e la rinominate 10402) cambiate la lingua di Visual Studio.Per questa ultima eventualità basta andare nel menù Strumenti/Opzioni:e cambiare il linguaggi…