ID Notification
copia linkIntroduzione
Questo componente permette di inviare notifiche locali e notifiche push alle applicazioni registrate per riceverle.
Badge Notification Images | Contiene le immagini che possono essere associate a una notifica di tipo badge per Windows 8 |
Notification Types | Rappresenta i diversi tipi di notifica che possono essere inviati ai dispositivi Android |
Notification Sounds | Rappresenta i diversi suoni che possono essere riprodotti dalle notifiche su Windows 8 |
DNID | Identificativo dell'applicazione che riceverà le notifiche e del dispositivo sul quale è installata |
Title | Titolo della notifica |
Message | Messaggio mostrato dalla notifica |
Fire Date | Data e ora di invio della notifica |
Payload | Dati inviati all'applicazione |
Image Path | Percorso dell'immagine mostrata dalla notifica |
Sound Path | Percorso del suono che deve essere riprodotto quando viene mostrata la notifica |
Badge No | Numero mostrato dal badge |
Expire Date | Data e ora di scadenza della notifica |
Access Token | Identificativo del server che invia la notifica |
Client ID | Chiave usata in combinazione con la proprietà Client Secret per ottenere l'identificativo del server |
Client Secret | Chiave usata in combinazione con la proprietà Client ID per ottenere l'identificativo del server |
Send | Permette di inviare una notifica |
Proprietà iOS | Elenco delle proprietà e metodi specifici per i dispositivi iOS |
Proprietà Android | Elenco delle proprietà e metodi specifici per i dispositivi Android |
Proprietà Win8 | Elenco delle proprietà e metodi specifici per i dispositivi Windows 8 |
Proprietà Chrome | Elenco delle proprietà specifiche per Chrome |
Configurazione sistema per notifiche su iOS (fino alla versione 20.5)
Per poter inviare notifiche locali, non è richiesta nessuna configurazione particolare. È sufficiente inviare una notifica dall'applicazione offline quando eseguita dentro alla shell nativa (pacchetto di installazione o browser Caravel).
Per poter inviare notifiche push in applicazioni offline eseguite dentro al browser Caravel, non è richiesta nessuna configurazione particolare.
Per poter inviare notifiche push in applicazioni offline eseguite dentro alla shell nativa ottenuta creando il pacchetto di installazione, occorre un apposito certificato, scaricabile dal sito di Apple. Per iniziare, occorre attivare il servizio "Push Notification" sul sito web https://developer.apple.com. Dopo aver effettuato il login, occorre selezionare la pagina App IDs e creare, qualora non sia già stato fatto, un nuovo ID per l'applicazione che si desidera installare. Qualora l'applicazione sia già stata creata, attivare il check Push Notifications. In fondo alla videata di dettaglio delle proprietà dell'applicazione vengono mostrati vari pulsanti tramite i quali è possibile creare e scaricare un certificato Developer (necessario se si installa l'applicazione sul dispositivo utilizzando XCode) e un certificato Production (necessario se si installa l'applicazione sul dispositivo scaricandola dall'AppStore). Dopo aver scaricato i due certificati, occorre installarli sul Mac facendo doppio clic o importandoli nell'applicazione Accesso Portachiavi.
Una volta installati i certificati sul Mac, occorre esportarli. Per farlo, aprire l'applicazione Accesso Portachiavi, selezionare il certificato che si desidera esportare (il nome dovrebbe essere "Apple Production IOS Push Services: [ID APPLICAZIONE]" per il certificato di produzione e "Apple Development IOS Push Services: [ID APPLICAZIONE]" per il certificato di sviluppo). Aprendo il menu contestuale selezionare la voce che permette di esportare il certificato. L'estensione corretta è .p12. A questo punto viene richiesta una password con la quale viene criptato il certificato. Tale password è quella che va indicata nella proprietà CertificatePassword. Il file deve essere fornito all'applicazione server che invia le notifiche valorizzando la proprietà CertificatePath.
Configurazione sistema per notifiche su Android (e iOS dalla versione 21.0)
Per poter inviare notifiche locali, non è richiesta nessuna configurazione particolare. È sufficiente inviare una notifica dall'applicazione offline quando eseguita dentro alla shell nativa (pacchetto di installazione o browser Caravel).
Per poter inviare notifiche push in applicazioni offline eseguite dentro al browser Caravel, non è richiesta nessuna configurazione particolare.
Per poter inviare notifiche push in applicazioni offline eseguite dentro alla shell nativa ottenuta creando il pacchetto di installazione occorre effettuare i seguenti passaggi:
- registrarsi sulla console di Firebase;
- creare un nuovo progetto;
- aggiungere l'applicazione iOS o Android fornendo le informazioni richieste;
- per le applicazioni Android scaricare il file google-services.json e copiarlo nella custom dentro alla cartella "Devices\Android\app" e aggiungerlo nel filelist.txt;
- per le applicazioni iOS scaricare il file GoogleService-Info.plist e copiarlo nella custom dentro alla cartella "Devices\iOS\__InstMob__" (non è necessario inserirne il nome nel file FileList.txt poichè il file è già presente, vuoto, nel template standard);
- nell'applicazione mittente delle notifiche impostare la proprietà ApiKey con la "Chiave API web" ottenibile dalla Console di Firebase.
Configurazione sistema per notifiche su Chrome
Per poter inviare notifiche push in applicazioni eseguite dentro Chrome ottenute creando il pacchetto di installazione, occorre:
-
ottenere il ClientID e il ClientSecret:
- fare login nella console di Google usando lo stesso account Google che verrà usato per caricare l'applicazione nel Chrome Store
- creare un nuovo progetto espandendo il menu a tendina in alto a sinistra e selezionando Create...
- dal menu sulla sinistra, selezionare la voce Services e abilitare Google Cloud Messaging for Chrome API
- dal menu sulla sinistra, selezionare la voce API Access e cliccare sul bottone Create an OAuth 2.0 client ID...
- compilare i campi e cliccare sul bottone Next
- nel campo Application type, selezionare Web application
- cliccare su more options, di fianco a Your site or hostname, e scrivere il seguente URL: https://developers.google.com/oauthplayground
- cliccare sul bottone Create client ID
- nella pagina che comparirà saranno presenti il ClientID e il ClientSecret da utilizzare per l'invio delle notifiche
-
ottenere il primo AccessToken e il RefreshToken
- fare login sull'Oauth 2.0 Playground di Google con lo stesso account Google che verrà usato per caricare l'applicazione nel Chrome Store
- cliccare sul bottone con il simbolo dell'ingranaggio nell'angolo in altro a destra
- selezionare Use your own OAuth credentials, scrivere nei rispettivi campi il ClientID e il ClientSecret e cliccare su Close
- nella sezione Step 1, sulla sinistra, scrivere nel campo input your own scope il seguente scope: https://www.googleapis.com/auth/gcm_for_chrome e cliccare sul bottone Authorize APIs
- si aprirà una nuova pagina in cui vengono chieste le autorizzazioni. Cliccare sul bottone Allow access
- nella sezione Step 2, cliccare sul bottone Exchange authorization code for tokens
- nei campi Refresh token e Access token ci saranno i valori da utilizzare per l'invio delle notifiche
-
creare il pacchetto da inviare al Chrome Store
- scaricare il pacchetto ed estrarre i file
-
nel file background.js sostituire il serverUrl e il clientURL.
Il serverURL è l'indirizzo del server che riceverà il device notification id inviato dall'applicazione al momento dell'avvio.
Il clientURL è l'indirizzo che verrà aperto quando l'utente cliccherà sulla notifica.
- se necessario, personalizzare i file del pacchetto. A questo link è possibile trovare una guida.
- zippare il pacchetto e fare login sulla Chrome Developer Dashboard
- cliccare sul bottone A new item, cliccare su Choose file, scegliere il pacchetto appena creato e cliccare su Upload
- se non ci sono errori, si aprirà una pagina in cui possono essere specificati tutti i dettagli relativi all'applicazione. Dopo aver riempito almeno i campi obbligatori, cliccare sul bottone Publish per pubblicare l'applicazione sul Chrome Web Store. Se è la prima volta che si pubblica un'applicazione sul Chrome Store, verrà richiesto il pagamento di una quota di registrazione pari a 5$.
Ultima modifica: 27/04/2022 / Validità: da 12.5.5400