Manuale
Introduzione
La barra laterale sinistra contiene collegamenti alle sezioni corrispondenti:
- Nome utente - collegamenti al profilo personale.
- Dashboard - visualizza lo stato attuale sotto forma di grafici.
- Applicazioni - gestione dell'applicazione.
- Codici di sblocco - codici di sblocco generati automaticamente o caricati da te.
- Pagamenti - cronologia dei pagamenti in entrata degli utenti.
- Manuale - questo manuale utente.
Dashboard
È possibile impostare filtri comuni per tutti i widget nella dashboard:
- Valuta - la valuta in cui saranno convertite le entrate e le uscite nella dashboard.
- Periodo - è il periodo di tempo per il quale i dati vengono visualizzati nei grafici e nelle tabelle nella dashboard. Determina l'intervallo durante il quale le informazioni e le statistiche su pagamenti, applicazioni e altri parametri vengono analizzate e visualizzate.
Saldo
Questa sezione della dashboard mostra i principali indicatori finanziari disponibili per i prelievi. Presenta dati aggregati relativi a tutti i pagamenti degli utenti, tenendo conto delle commissioni addebitate dai sistemi di pagamento e dal servizio PayToUse.
In questo blocco vengono visualizzati i seguenti importi:
- Lordo: il volume complessivo di tutti i pagamenti effettuati dagli utenti nel periodo selezionato, al lordo di eventuali commissioni.
- Netto: l'importo totale di tutti i pagamenti relativi al periodo selezionato, al netto delle commissioni del sistema di pagamento e del servizio PayToUse.
- In sospeso: l'importo netto dei pagamenti che non è ancora disponibile per il prelievo. I fondi diventano disponibili per il prelievo 7 giorni dopo l'effettuazione del pagamento.
- Disponibile: l'importo netto complessivo di tutti i pagamenti che possono già essere prelevati sul tuo conto. Si tratta dell'indicatore principale che riflette il tuo saldo effettivamente prelevabile.
I pagamenti Test sono esclusi da tutti e quattro gli importi sopra indicati, nonché dal widget Pagamenti sottostante - non comportano mai denaro reale.
Preleva
Sotto l'indicatore dell'importo disponibile è presente il pulsante "Preleva". Serve per avviare una richiesta di trasferimento dei fondi accumulati.
Cliccando su questo pulsante, si aprirà una finestra modale in cui dovrai specificare i dettagli di pagamento per il bonifico.
Nota importante: il sistema utilizza automaticamente per il prelievo l'intero importo disponibile indicato nel campo corrispondente. Non è possibile specificare un importo arbitrario inferiore al saldo disponibile. L'importo totale del prelievo corrisponde alla somma di tutti i pagamenti che presentano lo stato "disponibile per il prelievo".
Nella finestra modale è possibile selezionare l'importo e la valuta per il prelievo. Le valute disponibili dipendono dai metodi di pagamento utilizzati.
Nota: se la valuta selezionata non è supportata per il metodo di prelievo specificato, la richiesta di prelievo verrà respinta.
Per ulteriori dettagli sullo stato e sulla cronologia delle tue richieste di prelievo, consulta la sezione «Prelievi».
Pagamenti
Il widget Pagamenti include una tabella dei pagamenti raggruppati per applicazione per il periodo selezionato.
Campi della tabella:
- Applicazione - applicazione. Vengono visualizzate solo le applicazioni per le quali sono stati effettuati pagamenti durante il periodo selezionato.
- Pagamenti - numero di pagamenti.
- Importo lordo - l'importo totale di tutti i pagamenti degli utenti per il periodo selezionato, al lordo delle commissioni dei sistemi di pagamento e di PayToUse.
- Importo netto - l'importo totale di tutti i pagamenti per il periodo selezionato meno le commissioni dei sistemi di pagamento e PayToUse.
Il grafico mostra la dinamica dei valori Importo netto e Importo lordo per giorno.
Nuovi utenti
Il grafico dei nuovi utenti mostra due valori in dinamica per giorno:
- Nuovi utenti - il numero di nuove chiamate API. Gli accessi API vengono registrati solo se il parametro device - un identificatore unico del dispositivo - viene passato durante l'invio di una richiesta all'API. Questo parametro deve essere veramente unico per il dispositivo. (vedi Invio di una richiesta)
- Pagamenti - il numero di pagamenti nello stesso periodo per giorno.
Conversione
La metrica Conversione valuta l'efficacia con cui converti Nuovi utenti in Pagamenti.
Il grafico mostra il rapporto tra il numero di Pagamenti e il numero di Nuovi utenti, in percentuale.
Applicazioni
Quando accedi a questa sezione, si apre l'elenco delle tue applicazioni.
L'elenco delle colonne nella tabella delle applicazioni:
- # - identificatore unico dell'applicazione. Utilizzato durante la verifica del codice dell'applicazione o nella visualizzazione del modulo di pagamento.
- Nome - nome dell'applicazione. Il nome viene visualizzato solo a te nei report e nella dashboard. Cliccando sul nome dell'applicazione si apre la pagina di modifica dell'applicazione.
- Stato - lo stato attuale dell'applicazione. Corrisponde a quanto è avanzata la procedura guidata di configurazione. Può essere:
- Creato - l'applicazione è appena stata creata, il passaggio Applicazione non è ancora completato.
- Descrizione - il passaggio Descrizione non è ancora completato.
- Prezzo - il passaggio Prezzo non è ancora completato.
- Test - tutti i passaggi di configurazione sono completati, ma l'applicazione non è stata ancora lanciata. Può essere utilizzata per pagamenti di prova. Non è accessibile agli utenti finali.
- Avvia - l'applicazione è avviata e accetta pagamenti reali.
- Creato - la data di creazione dell'applicazione.
- Pulsanti di controllo aggiuntivi:
- Elimina - per rimuovere l'applicazione dall'elenco.
Creazione o modifica di un'applicazione
Per accettare pagamenti, è necessario compilare in sequenza tutti i dati necessari dell'applicazione e attivarla.
Il pulsante per creare una nuova applicazione si trova nella barra del titolo dell'elenco delle applicazioni.
Applicazione
Campi disponibili durante la creazione di un'applicazione:
- Nome - il nome dell'applicazione visibile solo a te nei report o nella dashboard. Il nome sarà visualizzato nell'intestazione della pagina dell'applicazione salvata. Finché l'applicazione non è salvata, al posto del nome viene visualizzato «Nuova app». Campo obbligatorio.
- Email di contatto - l'indirizzo email a cui vengono inviate le copie dei messaggi inviati agli utenti. Questo indirizzo è indicato anche nel campo «Reply-To» ed è quello a cui l'utente risponde all'email ricevuta con il codice. Campo obbligatorio. Per impostazione predefinita viene compilato con il valore del profilo dello sviluppatore; può essere modificato.
- Tipo di applicazione - tipo di applicazione:
- Singolo - un'applicazione normale con il proprio modulo di pagamento e i propri codici di sblocco.
- Gruppo con chiave per una sola app - un unico acquisto per più applicazioni. L'utente paga una volta sul modulo di pagamento del gruppo, e il codice può essere attivato in una qualsiasi delle applicazioni del gruppo. Dopo l'attivazione in un'applicazione, il codice non è più disponibile nelle altre.
- Gruppo con chiave per tutte le app - un unico acquisto per più applicazioni. L'utente paga una volta sul modulo di pagamento del gruppo e riceve un codice che funziona in tutte le applicazioni del gruppo. In ogni applicazione il codice viene attivato e collegato al dispositivo separatamente. La durata del codice è comune: viene calcolata dalla prima attivazione in una qualsiasi applicazione del gruppo.
- Elenco delle applicazioni del gruppo - mostrato per i tipi di gruppo. Seleziona un'applicazione nell'elenco e fai clic su Aggiungi. Al gruppo devono essere aggiunte almeno due applicazioni. Nell'elenco sono disponibili solo le tue applicazioni singole per cui vengono generati codici di sblocco. Per ogni applicazione del gruppo viene creata una copia del codice del gruppo, e nell'elenco dei codici di sblocco tali codici sono mostrati sotto il codice del gruppo con lo stato Sconosciuto.
- Abilita feedback durante il pagamento - aggiunge un campo al modulo di pagamento per consentire agli utenti di inserire testo libero. Il feedback viene aggiunto alla copia dell'email dello sviluppatore. Il feedback può anche essere visualizzato nei dettagli del pagamento.
Le modifiche vengono salvate automaticamente mentre digiti o cambi i valori: non c'è il pulsante Salva. Un messaggio appare solo se qualcosa non è stato possibile salvare. Puoi sempre tornare per apportare modifiche in seguito.
Passa da un passaggio all'altro nell'intestazione della pagina: resta in alto durante lo scorrimento. Il passaggio successivo diventa disponibile quando quello attuale è compilato; aprirlo salva il passaggio attuale.
Descrizione
Seleziona una lingua dall'elenco e clicca su Aggiungi.
Verrà visualizzata una scheda con i testi localizzati dell'applicazione per la lingua selezionata.
Lingue disponibili:
- Tedesco
- Inglese
- Francese
- Spagnolo
- Russo
- Cinese semplificato
I campi nella descrizione sono utilizzati per visualizzare informazioni nel modulo di pagamento e nel messaggio di risposta all'utente:
- Nome localizzato - il nome dell'applicazione per la lingua selezionata. Viene visualizzato nel modulo di pagamento e nell'email di notifica del pagamento. Per impostazione predefinita, quando si aggiunge una lingua, viene inserito il nome dell'applicazione. È possibile impostare un nome diverso per ogni lingua. Campo obbligatorio.
- Descrizione dell'applicazione - una breve descrizione dell'applicazione. Visualizzata nel modulo di pagamento sotto il nome dell'applicazione. Campo opzionale. Puoi lasciarlo vuoto se non vuoi che venga visualizzata alcuna descrizione.
- Messaggio di conferma dell'acquisto - informazioni aggiuntive che verranno inviate all'utente via email al termine del pagamento. Il testo di risposta è aggiunto alla fine dell'email dopo la risposta standard.
Devi aggiungere almeno una lingua per salvare e procedere alla pagina successiva.
La lingua del modulo di pagamento viene determinata automaticamente in base alle impostazioni del browser dell'utente. Contrassegna una delle lingue con il pulsante di opzione accanto alla sua scheda (suggerimento Usa predefinito): i suoi testi vengono mostrati quando la lingua dell'utente non è tra quelle aggiunte.
Per rimuovere una lingua, fai clic sul pulsante di eliminazione nella sua scheda e conferma l'eliminazione.
Le modifiche vengono salvate automaticamente mentre digiti o cambi i valori: non c'è il pulsante Salva. Un messaggio appare solo se qualcosa non è stato possibile salvare. Puoi sempre tornare per apportare modifiche in seguito.
Passa da un passaggio all'altro nell'intestazione della pagina: resta in alto durante lo scorrimento. Il passaggio successivo diventa disponibile quando quello attuale è compilato; aprirlo salva il passaggio attuale.
Prezzo
La pagina contiene un elenco di prezzi e campi correlati al pagamento:
- Periodo di prova - durata del periodo di prova.
- Unità di tempo - l'unità di tempo del periodo di prova. Ad esempio, se si specificano 7 giorni, 7 giorni dopo la prima chiamata API dell'applicazione verrà restituita una risposta che indica che il periodo di prova è scaduto. Viene salvato l'orario della prima chiamata del dispositivo.
- Metodo di calcolo del prezzo - Il metodo di calcolo del prezzo dall'elenco:
- Calcolo del prezzo in base alla durata - Nel modulo di pagamento, l'utente specifica il periodo di attivazione del codice e il prezzo è calcolato automaticamente secondo la tabella sottostante. L'utente riceve un codice di sblocco generato automaticamente nella email di risposta.
- Calcolo della durata in base al prezzo - Nel modulo di pagamento, l'utente seleziona un prezzo dall'elenco o inserisce il proprio valore, e il periodo viene calcolato automaticamente secondo la tabella sottostante. L'utente riceve un codice generato automaticamente nel messaggio di risposta.
- Codice permanente - Nel modulo di pagamento, l'utente seleziona un prezzo dall'elenco o inserisce il proprio valore. Dopo il pagamento, riceve nell'email di risposta un codice dall'elenco sottostante, corrispondente al prezzo selezionato.
- Donazione - Nel modulo di pagamento, l'utente seleziona un prezzo dall'elenco o inserisce il proprio valore. Per le applicazioni di tipo Donazione, non viene generato un codice di sblocco.
- Codice temporaneo con prezzo in base alla durata e Codice temporaneo con durata in base al prezzo - l'applicazione riceve dall'API un codice temporaneo per il dispositivo e lo mostra all'utente insieme a un codice QR che porta al modulo di pagamento. L'utente paga questo codice: il prezzo dipende dalla durata scelta, oppure la durata dipende dal prezzo pagato, come nei metodi precedenti. Dopo il pagamento, il codice viene attivato solo per questo dispositivo. Un tale codice non può essere reimpostato né trasferito su un altro dispositivo.
Per le applicazioni di gruppo sono disponibili solo i metodi Calcolo del prezzo in base alla durata e Calcolo della durata in base al prezzo. Per il metodo Donazione il periodo di prova non viene utilizzato.
La tabella Lista prezzi definisce i livelli di prezzo. Aggiungi una riga con il pulsante Aggiungi e rimuovila con il pulsante Elimina. Le colonne della tabella dipendono dal metodo di calcolo del prezzo:
- Durata, Prezzo - la durata del codice (un numero e un'unità di tempo: giorni, mesi, anni o per sempre) e il suo prezzo.
- Prezzo, Codice - per il metodo Codice permanente: il prezzo e il codice che l'utente riceve dopo averlo pagato (fino a 12 caratteri).
- Prezzo - per il metodo Donazione: solo gli importi suggeriti.
La riga contrassegnata con il pulsante di opzione (suggerimento Usa predefinito) è preselezionata nel modulo di pagamento.
Il prezzo è impostato in dollari statunitensi. Il prezzo minimo è di 1 dollaro statunitense.
Le modifiche vengono salvate automaticamente mentre digiti o cambi i valori: non c'è il pulsante Salva. Un messaggio appare solo se qualcosa non è stato possibile salvare. Puoi sempre tornare per apportare modifiche in seguito.
Passa da un passaggio all'altro nell'intestazione della pagina: resta in alto durante lo scorrimento. Il passaggio successivo diventa disponibile quando quello attuale è compilato; aprirlo salva il passaggio attuale.
Anteprima
In questa pagina si impostano i valori:
- Lunghezza del codice - lunghezza del codice generato, se applicabile.
- Set di caratteri del codice - insieme di caratteri da cui è generato il codice:
- Codice numerico - il codice è generato utilizzando solo le cifre da 0 a 9. Possono essere inclusi zeri iniziali nel codice. Gli zeri iniziali sono significativi durante la verifica del codice.
- Codice alfanumerico - il codice è generato utilizzando i caratteri 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, G, H, I, G, K, L, M, N, P, Q, R, S, T, U, V, X, Y, Z. Il codice viene generato e inviato all'utente in lettere maiuscole. Durante la verifica del codice non si distingue tra maiuscole e minuscole.
- Consenti zeri iniziali nel codice - consente gli zeri iniziali nel codice generato. Disponibile solo per il set di caratteri Codice numerico.
- Consenti il reinvio del codice tramite ID dispositivo - consente di reinviare il codice alla stessa email ripetendo il controllo dell'identificatore del dispositivo. Disponibile solo per le applicazioni singole.
- Designer di quadranti - l'app è un quadrante creato nel designer: questo passaggio mostra il designer al posto del link di pagamento e degli esempi di codice. Attivato per i quadranti creati dalla pagina principale.
- Data di rilascio - la data in cui l'applicazione diventa disponibile per gli utenti normali. Insieme a Gratuito per i beta tester dopo il rilascio, definisce un periodo gratuito per i dispositivi che contattano l'applicazione prima di questa data.
- Gratuito per i beta tester dopo il rilascio - la durata del periodo gratuito (nell'Unità di tempo selezionata) concessa ai dispositivi la cui prima chiamata API è avvenuta prima del Data di rilascio. I codici creati per tali dispositivi ottengono lo stato Sconosciuto.
- Collegamento per controllare il codice - un esempio di link da utilizzare per la verifica del codice.
- Collegamento per pagare - link di pagamento. Puoi copiare il link e incollarlo nella descrizione dell'applicazione sul sito in cui è pubblicata. Per ciascun dominio (https://pay-to-use.com per tutte le lingue, https://pay-to-use.ru solo per la lingua russa) viene generato un link e un codice QR separati, disponibili come schede sopra il campo del link. Parametri da passare:
- app - l'identificatore unico dell'applicazione. Parametro obbligatorio.
- amount - l'importo che verrà specificato nel campo prezzo durante l'acquisto. Il prezzo predefinito viene ignorato. Tuttavia, l'importo non può essere inferiore al prezzo minimo e non può essere inferiore al prezzo minimo impostato per l'applicazione. Parametro opzionale.
Il link Collegamento per pagare diventa accessibile pubblicamente solo una volta lanciata l'applicazione. Prima di allora, usa il pulsante Pagamento di prova qui sotto per aprire il modulo di pagamento con un token di accesso temporaneo firmato - lo stesso modulo e gli stessi metodi di pagamento di quello reale, ma non viene addebitato alcun denaro: un pagamento viene creato direttamente con lo stato Test, e un codice pienamente funzionante (se applicabile) viene generato e inviato via email immediatamente, senza passare dal sistema di pagamento. I pagamenti di prova sono visibili nell'elenco Pagamenti, contrassegnati con lo stato Test, ma esclusi dai totali del Saldo.
Il pulsante Pagamento di prova apre un menu a tendina per scegliere il dominio (https://pay-to-use.com o https://pay-to-use.ru) su cui aprire il modulo di pagamento di prova - entrambi sono ugualmente funzionali, la scelta conta solo se devi testare un comportamento specifico della lingua.
Per iniziare ad accettare pagamenti reali, disattiva Modalità di test. Prima assicurati che tutti i dati inseriti siano corretti. Le chiavi generate dall'applicazione non possono essere modificate. Finché la modalità test è attiva, accanto al nome dell'applicazione è mostrato il badge Test. Riattivare Modalità di test (dopo una conferma) interrompe l'accettazione dei pagamenti reali e rende di nuovo disponibile il pulsante Pagamento di prova.
Verifica del codice
Il controllo del codice di sblocco dell'applicazione avviene in 3 fasi:
- Scrittura e invio di una richiesta di verifica del codice
- Controlli sul lato API
- Ricezione ed elaborazione della risposta dell'API
Invio di una richiesta
Per verificare il codice, l'utente della tua applicazione deve inserirlo nel campo nelle impostazioni dell'applicazione.
<properties>
<property id="UnlockCode" type="string"></property>
<property id="UnlockResult" type="string">Checking...</property>
...
<properties>
<settings>
<setting propertyKey="@Properties.UnlockCode" title="@Strings.UnlockCode">
<settingConfig type="alphaNumeric" maxLength="12"/>
</setting>
<setting propertyKey="@Properties.UnlockResult" title="@Strings.UnlockResult">
<settingConfig type="alphaNumeric" readonly="true"/>
</setting>
...
</settings>
Quindi è necessario inviare una richiesta al server API Pay-to-use:
function onTemporalEvent() as Void {
var ds = System.getDeviceSettings();
return Toybox.Communications.makeWebRequest(
"https://api.pay-to-use.com", // URL API
{
"device" => ds.uniqueIdentifier, // identificatore univoco del dispositivo
"app" => "6", // ID della tua applicazione
"model" => ds.partNumber, // codice articolo del dispositivo
"code" => Application.Properties.getValue("UnlockCode") // valore del codice di sblocco nella tua applicazione
},
{
:method => Communications.HTTP_REQUEST_METHOD_POST,
:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
},
method(:onReceive)
);
}
Parametri della richiesta API:
- url - https://api.pay-to-use.com. L'uso del protocollo HTTPS è obbligatorio.
- Corpo della richiesta (i valori passati). Un dizionario di chiavi e valori:
- device - identificatore unico del dispositivo.
- app - identificatore unico della tua applicazione.
- model - identificatore del modello del dispositivo. Parametro facoltativo. I dati vengono utilizzati per visualizzare le statistiche relative ai nuovi dispositivi.
- code - codice di sblocco inserito dall'utente nelle impostazioni della tua applicazione.
- Opzioni di richiesta:
- :method - l'API supporta i metodi di richiesta GET e POST.
- :headers - per il metodo POST, i parametri devono essere passati nel formato JSON.
- :responseType - la risposta è restituita in formato JSON.
- responseCallback - un riferimento al metodo di callback, che deve accettare due argomenti:
- responseCode - il codice di intestazione della risposta del server.
- data - il contenuto se la richiesta è stata completata con successo, altrimenti null.
Controlli sul lato API
Se non vengono passati parametri all'API, l'API restituisce un'intestazione HTTP/1.1 404 Not Found.
Se almeno un parametro viene passato all'API, l'API restituisce l'intestazione HTTP/1.1 200 OK.
La risposta del server consiste in:
- response - codice di risposta
- msg - descrizione testuale della risposta
- expires - timestamp UNIXTIME (se applicabile)
Viene eseguito un controllo per garantire che l'identificatore dell'applicazione passato sia corretto. L'applicazione deve essere nello stato Rilasciato al momento del pagamento. In caso di errore, viene restituito il codice di risposta 301.
Se viene trasmesso un ID dispositivo unico, viene cercato e memorizzato l'ID dispositivo. Se si verificano errori durante il controllo o il salvataggio, viene restituito il codice di errore 402. Se ricevi un codice di ritorno di questo tipo, scrivi immediatamente al supporto all'indirizzo [email protected]
Se il codice viene passato, vengono eseguiti i seguenti passaggi per le applicazioni con i metodi di calcolo Calcolo del prezzo in base alla durata e Calcolo della durata in base al prezzo:
- Se viene trasmesso un codice vuoto, viene staccato dall'identificatore unico del dispositivo definito nei passaggi precedenti.
- Se viene trasmesso un codice non vuoto e non è attivato, il codice viene attivato a seconda delle condizioni del prezzo specificate al momento dell'acquisto del codice, indipendentemente dalla data di attivazione.
- Se non viene trasmesso alcun codice o se il codice trasmesso non viene trovato, viene restituito il codice di errore 201.
- Il codice attivato viene controllato rispetto al dispositivo e, se durante l'attivazione è stato trasmesso un identificatore unico del dispositivo diverso da quello memorizzato, viene restituito il codice di errore 202.
- Se il codice trasmesso non ha una data di scadenza e tutti i controlli precedenti sono stati superati, viene restituito il codice 101.
- Se il codice è a tempo limitato, viene eseguito un controllo. Se la chiave non è scaduta, viene restituito il codice 101. Se il codice è scaduto, viene restituito il codice di errore 203.
- Questo tipo di applicazione richiede che il codice sia vincolato al dispositivo. Se l'ID dispositivo unico non è stato trasmesso, viene restituito il codice di errore 304.
Per un'applicazione con un metodo di calcolo Codice permanente, viene verificata solo la disponibilità del codice al momento dell'acquisto. Se viene trovato un codice, viene restituito il codice 101. Se non viene trovato alcun codice, viene restituito il codice di errore 201.
Per un'applicazione con il metodo di calcolo Donazione, il codice non viene verificato. Il codice 101 viene sempre restituito.
Se viene trasmesso un codice vuoto e nell'applicazione è compilato il campo Data di rilascio, viene controllato il periodo per i beta tester: se il dispositivo ha contattato l'API per la prima volta prima della data di rilascio e il periodo Gratuito per i beta tester dopo il rilascio non è ancora scaduto, viene restituito il codice 103.
Se l'opzione Consenti il reinvio del codice tramite ID dispositivo è attivata e non viene trasmesso alcun codice, viene cercato un codice valido già collegato al dispositivo. Se viene trovato, viene restituito il codice 101 insieme al codice stesso.
Se i controlli precedenti non sono stati superati, viene verificato il periodo di prova. Se è trascorso più tempo dal primo contatto del dispositivo rispetto alle impostazioni correnti dell'applicazione, viene restituito il codice di errore 204. Se il periodo di prova non è ancora scaduto, viene restituito il codice di errore 102.
Se viene trasmesso solo l'ID dell'applicazione e non vengono trasmessi né il codice di sblocco né l'ID dispositivo unico, viene restituito il codice di errore 303.
Se la risposta restituita è 500, scrivi al supporto all'indirizzo [email protected]
Di seguito è riportata una tabella di tutti i codici restituiti:
| Codice | Messaggio |
|---|---|
| 101 |
Metodi di calcolo Calcolo del prezzo in base alla durata e Calcolo della durata in base al prezzo:
|
| |
Codice permanente:
| |
Donazione:
| |
| 102 | |
| 103 | |
| 201 | |
| 202 | |
| 203 | |
| 204 | |
| 301 | |
| 302 | |
| 303 | |
| 304 | |
| 401 | |
| 402 | |
| 500 | |
Verifica della risposta
Quindi è necessario verificare la risposta dal server API Pay-to-use:
function onReceive(responseHeader, data) as Void {
if (responseHeader == 200) { Toybox.Background.exit(data); }
}
È possibile controllare tutte le intestazioni e i codici, è possibile visualizzare i propri messaggi per la comodità dell'utente, ma nella forma più semplice la verifica avrà un aspetto simile a questo:
function onBackgroundData(data) as Void {
if (data.hasKey("response")) {
if (data.hasKey("msg")) {
// Puoi mostrare data["msg"] nel campo delle proprietà con il nome "UnlockResult".
Application.Properties.setValue("UnlockResult", data["msg"]);
}
if (data["response"].toString().substring(0, 1).equals("2")) {
// Verifica del codice fallita
// Le funzioni a pagamento NON sono disponibili
...
} else {
// La verifica del codice è riuscita oppure l'errore dipende da te o dall'API
// Le funzioni a pagamento sono disponibili
...
}
}
}Codici di sblocco
Quando si accede a questa sezione, si aprirà un elenco di codici di sblocco.
Elenco dei codici di sblocco
È possibile cercare per email o per codice nella barra di ricerca in alto. I codici trovati saranno visualizzati nell'elenco. È possibile utilizzare l'email o il codice, completi o in parte, come criterio di ricerca. Le corrispondenze saranno evidenziate a colori. Ricerca e filtri funzionano simultaneamente e non si escludono a vicenda.
L'ultimo filtro utilizzato viene memorizzato per l'utente. Quindi, la prossima volta che si accede alla pagina, l'ultimo filtro utilizzato verrà applicato automaticamente. Sono disponibili filtri per l'elenco dei codici di sblocco:
- Colonne - seleziona le colonne della tabella da visualizzare nell'elenco dei codici di sblocco.
- Applicazione - mostra solo i codici di sblocco per le applicazioni selezionate.
- Stato - mostra solo i codici di sblocco che si trovano nello stato selezionato.
Elenco delle colonne nella tabella dei codici di sblocco:
- Applicazione - la tua applicazione. Puoi seguire il link per modificarne le impostazioni.
- Codice - il codice di sblocco.
- Email - l'indirizzo email associato alla registrazione del codice di sblocco. Questo indirizzo viene utilizzato per cercare i codici di sblocco dei clienti nella sezione I miei acquisti del sito web. Questa sezione è accessibile agli utenti.
- Durata - il periodo di validità del codice inviato (specificato nelle impostazioni dell'applicazione). Un periodo di validità è impostato per il codice, corrispondente alle condizioni delle impostazioni dell'applicazione al momento della sua creazione.
- Stato - lo stato del codice di sblocco. (vedi Stato del codice di sblocco)
- Creato - la data di creazione del codice di sblocco.
- Lingua - la lingua dell'utente, utilizzata per i messaggi con il codice.
- Attivazione - la data di attivazione del codice. Viene impostata nel momento in cui questo particolare dispositivo dell'utente contatta per la prima volta il servizio API PayToUse e invia questo codice. Lo stato del codice cambia in Attivato. Solo un codice inattivo può essere attivato. Se un codice attivo viene inviato da un dispositivo con un ID diverso, l'API restituisce l'errore 202. Solo un dispositivo può essere collegato a un singolo codice.
- Scadenza - la data di scadenza dell'attivazione del codice. Impostata per i codici che hanno un periodo di validità limitato all'attivazione del codice. Per i codici con data di scadenza illimitata, il campo rimane vuoto.
- Eliminato - la data di eliminazione del codice. Alla cancellazione, lo stato del codice viene impostato su Sconosciuto.
- Dispositivo - l'identificatore univoco del dispositivo a cui è collegato il codice.
- Primo accesso del dispositivo - la data della prima chiamata all'API dal dispositivo. Il periodo di prova e il periodo per i beta tester sono calcolati da questa data.
- Ultimo accesso del dispositivo - la data dell'ultima chiamata all'API dal dispositivo. Permette di verificare se l'applicazione è ancora in uso.
- Pagamento n. - numero di sequenza unico del pagamento. Puoi fare clic sul link per visualizzare i dettagli del pagamento.
- Note - note inserite durante la creazione manuale dei codici.
- Pulsanti per le azioni con i codici di sblocco. Ad esempio, cancellazione.
Stato del codice di sblocco
Nel corso del suo ciclo di vita, il codice di sblocco passa attraverso diversi stati, che possono essere monitorati dallo stato del codice.
| Stato | Descrizione |
|---|---|
| Disponibile | Lo stato viene assegnato a un codice di sblocco per il quale non sono state eseguite azioni o se il collegamento del dispositivo è stato ripristinato per il codice. |
| Attivato | Lo stato è impostato per un codice con una data di attivazione impostata. La data di attivazione viene impostata quando il dispositivo accede con successo al servizio API PayToUse per la prima volta. Inoltre, durante l'attivazione del codice, viene impostata la data di scadenza del codice. |
| Scaduto | Lo stato è impostato per un codice scaduto. Il distacco del codice dal dispositivo non ripristina la data di scadenza del codice. Il controllo del codice con questo stato restituirà l'errore 203. (vedi Controlli sul lato API) |
| Sconosciuto | Lo stato è impostato quando il codice viene eliminato. Il controllo del codice con questo stato restituirà l'errore 201. (vedi Controlli sul lato API) |
| Sconosciuto | Lo stato viene assegnato a un codice creato per un dispositivo la cui prima chiamata API è avvenuta prima della Data di rilascio dell'applicazione - gli viene concesso un periodo gratuito al posto della prova consueta o dell'attivazione a pagamento, come configurato da Gratuito per i beta tester dopo il rilascio. |
| Sconosciuto | Lo stato viene assegnato a un codice condiviso da più applicazioni raggruppate. Non è legato a una singola applicazione e non appare nell'elenco dei codici delle singole applicazioni del gruppo. |
| Sconosciuto | Come Sconosciuto, ma il codice non è più disponibile: è stato eliminato oppure, per un gruppo con chiave per una sola applicazione, è già stato attivato in una delle applicazioni del gruppo. L'eliminazione del codice del gruppo elimina anche le sue copie in tutte le applicazioni del gruppo. |
| Sconosciuto | Lo stato viene assegnato a un codice appartenente a un'applicazione all'interno di un gruppo quando viene eliminato individualmente, mentre il codice del gruppo stesso rimane. |
Dettagli del codice
Facendo clic sul codice nell'elenco si apre la pagina dei dettagli del codice. Mostra gli stessi campi dell'elenco e i pulsanti per le azioni con il codice:
- Resetta - scollega il codice dal dispositivo e reimposta la data di attivazione. Lo stato del codice diventa Disponibile, e il codice può essere attivato su un altro dispositivo, ad esempio quando l'utente ha sostituito il dispositivo. La data di scadenza di un codice già attivato non viene reimpostata. Il pulsante non è disponibile per le applicazioni con codici temporanei, perché un tale codice può essere usato solo su un dispositivo.
- Attiva - disponibile per un codice temporaneo non ancora pagato. Inserisci l'email dell'utente e la durata del codice: il codice viene attivato per il dispositivo a cui è collegato, come se fosse stato pagato. Usalo, ad esempio, per dare l'applicazione all'utente gratuitamente.
- Invia codice - invia un'email con il codice e i suoi dettagli all'email del codice. Seleziona la Lingua del messaggio. Se Invia una copia allo sviluppatore è selezionato, una copia dell'email viene inviata all'email di contatto dell'applicazione. Usalo quando l'utente ha perso l'email con il codice.
- Cambia email - modifica l'email del codice. Per un codice di gruppo, l'email viene modificata per il codice del gruppo e per tutte le sue copie. Se il codice è stato ottenuto a seguito di un pagamento, viene modificata anche l'email del pagamento. L'utente troverà quindi il codice nella sezione I miei acquisti con la nuova email.
- Elimina - elimina il codice. Lo stato del codice diventa Sconosciuto, e la verifica del codice restituisce l'errore 201. Un codice temporaneo non pagato viene eliminato completamente.
Le azioni con il codice sono disponibili anche nella pagina dei dettagli del pagamento, se per il pagamento è stato inviato un codice.
Crea
Il pulsante Crea nella barra del titolo dell'elenco dei codici di sblocco apre il modulo per creare codici senza pagamento. Ad esempio, per beta tester, recensori o utenti che hanno pagato in altro modo. Campi del modulo:
- Email - l'indirizzo a cui vengono inviati i codici creati. Una copia dell'email viene inviata all'email di contatto dell'applicazione.
- Applicazione - l'applicazione per cui vengono creati i codici. Sono disponibili solo le applicazioni negli stati Test e Avvia con il metodo di calcolo del prezzo Calcolo del prezzo in base alla durata o Calcolo della durata in base al prezzo.
- Durata e Unità di tempo - il periodo di validità dei codici. Viene calcolato dal momento dell'attivazione del codice sul dispositivo.
- Quantità - il numero di codici da creare.
- Note - testo libero salvato con i codici. Viene mostrato nella colonna Note dell'elenco.
- Includi le note nell'email - aggiunge le note all'email con i codici.
I codici vengono generati secondo le impostazioni del codice dell'applicazione (lunghezza e set di caratteri). Dopo il salvataggio, viene visualizzato l'elenco dei codici creati e viene inviata l'email.
Carica
Il pulsante Carica consente di caricare codici emessi al di fuori di PayToUse, ad esempio durante il passaggio da un altro sistema di licenze. Seleziona l'applicazione, il file e i parametri del file:
- Formato del file - CSV, codifica UTF-8. La dimensione massima del file è indicata nel modulo di caricamento.
- contiene intestazioni - seleziona se la prima riga del file contiene i nomi delle colonne. In tal caso la prima riga viene saltata.
- Delimitatore - punto e virgola, virgola o tabulazione.
Colonne del file, in questo ordine:
- Codice - il codice di sblocco, obbligatorio. Viene convertito in maiuscolo e troncato a 12 caratteri. I codici già esistenti per l'applicazione vengono saltati.
- Email - l'email dell'utente.
- Creato - la data di creazione: una data o un timestamp UNIXTIME. Se vuoto, viene usata la data del caricamento.
- Scadenza - la data di scadenza: una data o un timestamp UNIXTIME. Lascia vuoto se il codice non è ancora stato attivato o non ha una data di scadenza.
- Durata - il periodo di validità dopo l'attivazione: un numero e un'unità, ad esempio 12h, 30d, 6m o 1y. Se vuoto, il codice è valido per sempre.
Dopo il caricamento viene visualizzata la tabella delle righe caricate. Le righe non caricate sono evidenziate in rosso, e un messaggio indica quante righe sono state inserite sul totale. Durante il caricamento non vengono inviate email agli utenti.
Scarica
Il pulsante Scarica scarica l'elenco dei codici di sblocco in un file CSV. Nel modulo, seleziona i campi da includere nel file. Il file contiene tutti i codici che corrispondono ai filtri e alla ricerca correnti, non solo i codici della pagina corrente. I campi selezionati vengono ricordati per il download successivo.
Pagamenti
Quando accedi a questa sezione, si aprirà un elenco dei pagamenti degli utenti.
I seguenti sistemi di pagamento sono utilizzati per ricevere pagamenti:
Dopo le commissioni del sistema di pagamento, PayToUse addebiterà una commissione del 13%. Stiamo costantemente lavorando per ridurre le commissioni.
Se nel sistema di pagamento sorgono controversie o rimborsi, le penali del sistema di pagamento vengono addebitate allo sviluppatore. Pertanto dovresti evitare che si verifichino tali situazioni. In caso di controversia la commissione PayToUse non viene addebitata.
Elenco dei pagamenti
È possibile cercare nel campo email o nel codice inviato nella barra di ricerca in alto. I pagamenti trovati saranno visualizzati nell'elenco. Puoi utilizzare tutto o parte dell'email o del codice inviato come criterio di ricerca. Le corrispondenze saranno evidenziate a colori. La ricerca e i filtri funzionano simultaneamente e non si escludono a vicenda.
Per l'utente viene memorizzato l'ultimo filtro utilizzato. Quindi, la prossima volta che si accede alla pagina, l'ultimo filtro utilizzato verrà applicato automaticamente. Sono disponibili filtri per l'elenco dei pagamenti:
- Colonne - seleziona le colonne della tabella da visualizzare nell'elenco dei pagamenti.
- Periodo - mostra solo i pagamenti creati nell'intervallo di date selezionato.
- Applicazione - visualizzazione dei pagamenti solo per le applicazioni selezionate.
- Sistema - visualizzazione dei pagamenti solo dai sistemi di pagamento selezionati.
- Stato - visualizzazione dei pagamenti solo con stati selezionati.
L'elenco delle colonne nella tabella dei pagamenti:
- Applicazione - la tua applicazione. Puoi seguire il link per modificarne le impostazioni.
- # - numero di sequenza univoco del pagamento. Viene assegnato automaticamente al pagamento quando l'utente passa dal modulo di pagamento alla pagina di pagamento nel sistema di pagamento. Puoi fare clic sul collegamento per visualizzare i dettagli del pagamento.
- Commenti - messaggio dall'utente inserito nel modulo di pagamento.
- Sistema - il sistema di pagamento selezionato dall'utente.
- Stato - lo stato del pagamento. (vedi Stato del pagamento)
- Email - email dell'utente indicata nel modulo di pagamento.
- Durata - periodo di validità del codice inviato (specificato nelle impostazioni dell'applicazione).
- Lingua - la lingua del modulo di pagamento scelta dall'utente.
- Creato - data di creazione del pagamento.
- Importo della fattura - l'importo del pagamento addebitato all'utente. Specificato nel modulo di pagamento in base alle impostazioni dell'applicazione.
- Data del pagamento - data del pagamento.
- Importo del pagamento - l'importo del pagamento confermato dal sistema di pagamento.
- Codice inviato - codice inviato all'utente.
- Importo disponibile - importo di prelievo disponibile.
- Importo del prelievo - l'importo dei fondi prelevati per il pagamento.
Dettagli del pagamento
Facendo clic sul # di un pagamento nell'elenco si apre la relativa pagina di dettaglio.
Oltre ai campi già elencati sopra, la pagina di dettaglio mostra:
- Codice - il codice inserito dall'acquirente nel modulo di pagamento, prima che venga verificato e attivato. Mostrato solo per le applicazioni con codici temporanei associati a un dispositivo.
- Importo del pagamento (Lordo) - l'importo confermato dal sistema di pagamento, prima delle commissioni del sistema di pagamento e di PayToUse.
- Importo del pagamento (Netto) - l'importo confermato dal sistema di pagamento, dopo le commissioni del sistema di pagamento e di PayToUse.
-
Identificatori di pagamento - identificatori assegnati dal sistema di pagamento, utilizzati per cercare il pagamento al suo interno se necessario. I campi mostrati dipendono dal sistema di pagamento:
- Stripe: Payment Intent, Ricevuta #, Ultime 4 cifre.
- PayPal: ID Pagamento, ID Pagatore, ID Transazione.
- Robokassa: ID Pagamento, ID1, ID2.
Se per il pagamento è stato inviato un codice, nella pagina dei dettagli del pagamento sono disponibili i pulsanti Resetta codice, Invia codice e Cambia email. Funzionano come nella pagina dei dettagli del codice. (vedi Dettagli del codice)
Stato del pagamento
Durante il suo ciclo di vita, il pagamento passa attraverso diversi stati, che possono essere monitorati dallo stato del pagamento.
| Stato | Descrizione |
|---|---|
| Incompleto | Lo stato è assegnato ai pagamenti per i quali non sono state eseguite azioni. Il pagamento viene creato non appena l'utente passa dal modulo di pagamento al modulo del sistema di pagamento. Al pagamento viene assegnato un numero seriale unico, così come gli attributi di base del pagamento: importo, sistema di pagamento, data. |
| Riuscito | Lo stato è assegnato ai pagamenti che hanno ricevuto una risposta positiva dal sistema di pagamento. Il passo successivo è inviare un'email all'utente contenente il codice generato o altre informazioni a seconda delle impostazioni dell'applicazione. Se il pagamento rimane in questo stato, è necessario prestare particolare attenzione, poiché le azioni successive non sono state eseguite. |
| Errore | Lo stato è assegnato ai pagamenti per i quali viene ricevuta una risposta negativa dal sistema di pagamento. Le azioni successive non vengono eseguite. È necessario prestare particolare attenzione a tali pagamenti, poiché lo stato sul lato del sistema di pagamento può essere elaborato con un ritardo. |
| In attesa | Lo stato viene assegnato ai pagamenti per i quali è stata ricevuta una risposta positiva dal sistema di pagamento e tutti i passaggi successivi sono stati completati con successo. Per i pagamenti con questo stato il prelievo non è disponibile. I pagamenti passano automaticamente allo stato successivo dopo 7 giorni. |
| Disponibile | Il prelievo è disponibile per i pagamenti in questo stato. |
| Invio | Lo stato viene assegnato ai pagamenti inclusi nel prossimo prelievo. Se il prelievo viene annullato o respinto, lo stato del pagamento torna a Disponibile. |
| Inviato | Lo stato viene assegnato ai pagamenti per i quali è stato effettuato il prelievo. È in attesa di conferma del ricevimento dei fondi. |
| Completato | Lo stato viene assegnato ai pagamenti con prelievi completati con successo. Puoi impostare manualmente lo stato confermando il prelievo nella sezione corrispondente. Lo stato viene anche modificato automaticamente 14 giorni dopo il prelievo del pagamento. |
| Rimborsato | I pagamenti per i quali è stato emesso un rimborso passano a questo stato. All'emissione di un rimborso viene addebitata una commissione di rimborso. La commissione viene detratta dall'importo del prelievo. |
| Rimborso chiuso | Un rimborso che era incluso in un prelievo già inviato. La commissione di rimborso viene invece detratta dal saldo dello sviluppatore, poiché l'importo prelevato non può più essere ridotto. |
| Controversia | L'acquirente ha contestato (chargeback) il pagamento presso il sistema di pagamento. L'esito è in sospeso. |
| Controversia chiusa | La contestazione è stata risolta. Come per un rimborso, qualsiasi commissione di contestazione addebitata dal sistema di pagamento viene trasferita allo sviluppatore. |
| Annullato | Il pagamento è stato annullato prima del completamento. |
| Sconosciuto | Assegnato durante la riconciliazione dei record di pagamento con un report del sistema di pagamento il cui testo di stato non corrisponde a nessuno degli stati noti sopra elencati. Richiede una revisione manuale. |
| Test | Un pagamento di prova effettuato tramite il Modalità di test dell'applicazione mentre si trova nello stato Test, prima del lancio. L'importo e qualsiasi codice generato sono reali, ma non viene addebitato alcun denaro e il pagamento è escluso dai totali della dashboard. |
Scarica
Il pulsante Scarica nella barra del titolo dell'elenco dei pagamenti scarica l'elenco in un file Excel (XLSX). Il file contiene le colonne selezionate nel filtro Colonne, nello stesso ordine, e tutti i pagamenti che corrispondono ai filtri e alla ricerca correnti, non solo i pagamenti della pagina corrente.
Prelievi
Quando accedi a questa sezione, si aprirà un elenco dei tuoi prelievi.
Preleva
Il pulsante "Preleva" serve per avviare una richiesta di trasferimento dei fondi accumulati.
Cliccando su questo pulsante, si aprirà una finestra modale in cui dovrai specificare i dettagli di pagamento per il bonifico.
Nota importante: il sistema utilizza automaticamente per il prelievo l'intero importo disponibile indicato nel campo corrispondente. Non è possibile specificare un importo arbitrario inferiore al saldo disponibile. L'importo totale del prelievo corrisponde alla somma di tutti i pagamenti che presentano lo stato "disponibile per il prelievo".
Nella finestra modale è possibile selezionare l'importo e la valuta per il prelievo. Le valute disponibili dipendono dai metodi di pagamento utilizzati.
Nota: se la valuta selezionata non è supportata per il metodo di prelievo specificato, la richiesta di prelievo verrà respinta.
Elenco dei prelievi
L'ultimo filtro utilizzato viene memorizzato per l'utente. Quindi, la prossima volta che accedi alla pagina, l'ultimo filtro utilizzato verrà applicato automaticamente. Sono disponibili filtri per l'elenco dei prelievi:
- Colonne - mostra solo le colonne selezionate nell'elenco dei prelievi.
- Stato - mostra solo i prelievi che sono nello stato selezionato.
L'elenco delle colonne nella tabella dei prelievi:
- # - numero di sequenza unico del prelievo. Viene assegnato automaticamente al prelievo quando viene salvato. Puoi fare clic sul link per visualizzare i dettagli del prelievo.
- Stato - lo stato del prelievo. (vedi Stato del prelievo)
- Creato - la data della richiesta di prelievo.
- Importo - l'importo del prelievo.
- Prelievo - la data in cui è stato inviato il prelievo.
- Pulsanti per le azioni con i prelievi. Ad esempio, conferma.
Puoi confermare il prelievo quando è nello stato Inviato.
Dettagli del prelievo
Facendo clic sul # di un prelievo nell'elenco si apre la sua pagina dei dettagli. Oltre ai campi dell'elenco, mostra i Dettagli - i dati di pagamento indicati nella richiesta di prelievo, su cui vengono trasferiti i fondi.
Di seguito l'elenco dei pagamenti inclusi nel prelievo. Per esso sono disponibili i filtri Colonne, Applicazione, Sistema e Stato, come nell'elenco dei pagamenti. (vedi Elenco dei pagamenti)
Stato del prelievo
Nel corso del suo ciclo di vita, il prelievo passa attraverso diversi stati, che possono essere monitorati dallo stato del prelievo.
| Stato | Descrizione |
|---|---|
| In attesa | Lo stato viene assegnato ai prelievi al momento della creazione, finché non è stata eseguita alcuna azione. |
| Annullato | Lo stato viene assegnato ai prelievi annullati. Le cancellazioni possono essere effettuate per vari motivi. Ad esempio, il metodo di ricezione dei fondi non è specificato. Tutti i pagamenti da questo prelievo vanno allo stato Disponibile e sono disponibili per il prelievo nuovamente. |
| Inviato | Lo stato è impostato per il prelievo dei fondi quando viene inviato. |
| Completato | Lo stato viene impostato per un prelievo manuale quando lo sviluppatore conferma la ricezione dei fondi, oppure automaticamente 14 giorni dopo l'invio. |
| Rifiutato | Lo stato è impostato per il prelievo quando la banca o il sistema di pagamento restituiscono i fondi dopo l'invio. Tutti i pagamenti da questo prelievo passano allo stato Disponibile e sono disponibili per il prelievo nuovamente. |
Designer di quadranti
Il designer crea quadranti Garmin Connect IQ per la tua app senza programmare. Posizioni gli elementi sullo schermo di ogni modello di orologio, scegli cosa mostrano e quali sono a pagamento, e scarichi un file pronto: .prg da installare sul tuo orologio per le prove o .iq da pubblicare nel Connect IQ Store.
Il quadrante finito verifica da solo il pagamento tramite PayToUse, secondo il metodo di pagamento dell'app. Non è necessario scrivere codice.
Il designer si apre con il pulsante a forma di razzo accanto al nome dell'app nella pagina dell'app.
Chiave sviluppatore Connect IQ
Ogni file .prg e .iq è firmato con la chiave sviluppatore, una chiave privata RSA a 4096 bit. Si imposta una volta nel Profilo e viene usata per tutti i quadranti dello sviluppatore.
- Se hai già delle app nel Connect IQ Store, carica la chiave con cui le hai firmate: il file developer_key creato dal Connect IQ SDK (ad esempio con il comando "Monkey C: Generate a Developer Key" in Visual Studio Code). Un'app pubblicata nello store può essere aggiornata solo con la stessa chiave.
- Se non hai ancora una chiave, generala con il pulsante «Genera una nuova chiave». Questa chiave è adatta per installare quadranti sul tuo orologio e per nuove app nello store, ma le app già pubblicate con un'altra chiave non possono essere aggiornate con essa.
- Scarica la chiave e conservane una copia in un luogo sicuro. Se la chiave viene persa, le app pubblicate con essa non potranno più essere aggiornate nello store.
- Sono accettati file in formato DER o PEM. La chiave non deve essere protetta da password.
Importante: la sostituzione della chiave riguarda tutti i quadranti dello sviluppatore. La chiave precedente viene conservata sul server, ma le nuove compilazioni sono firmate con quella nuova.
Modelli di orologio
L'elenco dei modelli disponibili nel designer è definito dall'amministratore nella pagina Modelli di orologio: modelli rotondi e rettangolari con Connect IQ 4 e successivi. Nel designer i modelli per il quadrante si scelgono con il pulsante Modelli.
Ogni modello ha il proprio layout: posizione, dimensione e font degli elementi si impostano separatamente, mentre l'elenco degli elementi, le funzioni e le impostazioni di pagamento sono comuni a tutti i modelli. Un nuovo modello riceve il layout del modello attuale adattato al suo schermo.
- Orologio / Schermo - mostrare lo schermo sull'immagine dell'orologio o solo lo schermo.
- Dimensioni reali - mostrare l'orologio nelle dimensioni reali.
- Always On - anteprima della modalità Always On degli schermi AMOLED.
Elementi
Un quadrante è composto da elementi di quattro tipi:
- Testo - mostra il valore di una funzione: ora, data, passi, frequenza cardiaca, meteo e così via.
- Testo fisso - testo che inserisci tu stesso.
- Lancette - lancette analogiche di ore, minuti e secondi.
- Immagine - un'immagine: sfondo o livello sopra gli altri elementi.
Gli elementi sono disegnati nell'ordine dell'elenco nella scheda Elementi: il primo è il livello inferiore. L'ordine si cambia con le frecce nell'elenco e i pulsanti Sullo sfondo e In primo piano.
Gli elementi si spostano con il mouse o con le frecce della tastiera (1 px, con Maiusc 10 px). Ctrl+D duplica l'elemento, Ctrl+C / Ctrl+V ne copiano la posizione in un altro modello, Canc lo elimina. Il pulsante Copia in tutti i modelli trasferisce la posizione dell'elemento a tutti i modelli selezionati. Il pulsante Copia tutto in tutti i modelli sostituisce i layout di tutti gli altri modelli con quello del modello corrente: tutti gli elementi e lo sfondo, ridimensionati per ogni schermo.
Funzioni e pagamento
Un elemento di testo può avere più funzioni. Una di esse è mostrata per impostazione predefinita; se è attivo L'utente può scegliere la funzione nelle impostazioni, l'utente dell'orologio sceglie la funzione nelle impostazioni del quadrante in Garmin Connect.
Ogni funzione di ogni elemento può essere contrassegnata come a pagamento: la stessa funzione può essere gratuita in un elemento e a pagamento in un altro. La scheda Funzioni mostra tutte le funzioni e gli elementi utilizzati in un'unica tabella.
Le funzioni contrassegnate da un asterisco richiedono un'autorizzazione aggiuntiva (cronologia dei sensori, profilo utente o posizione), che lo store mostra durante l'installazione del quadrante. L'autorizzazione viene aggiunta al quadrante solo se usa tali funzioni. Alba e tramonto, così come le icone giorno/notte, richiedono la posizione: l'ultima posizione GPS dell'orologio (aggiornata da qualsiasi attività con GPS), altrimenti la località delle previsioni meteo.
Senza pagamento il quadrante si comporta in base al metodo di pagamento dell'app:
| Metodo di pagamento | Senza pagamento |
|---|---|
| Calcolo del prezzo in base alla durata, Calcolo della durata in base al prezzo, Codice permanente | Le funzioni a pagamento mostrano «paid», le immagini a pagamento sono nascoste. Il codice di sblocco si inserisce nelle impostazioni del quadrante; il codice QR della pagina di acquisto è nel menu delle impostazioni dell'orologio. |
| Codice temporaneo con prezzo in base alla durata, Codice temporaneo con durata in base al prezzo | Se il quadrante usa funzioni a pagamento, mostra una schermata di blocco con il codice dell'orologio e il codice QR della pagina di pagamento. |
| Donazione | Non c'è verifica del pagamento, i contrassegni a pagamento vengono ignorati. |
Sugli schermi touch un tocco su un quadrante bloccato apre tutte le funzioni per 15 minuti come prova.
Icone
Un elemento di testo può mostrare un'icona accanto al valore della funzione. L'icona appartiene alla funzione in tutto il quadrante: si modifica nella colonna Icona della tabella delle funzioni di un elemento o nella scheda Funzioni, e la modifica vale per tutti gli elementi con questa funzione.
- Dal dizionario (predefinito) - l'icona che l'amministratore ha impostato per questa funzione nel dizionario delle icone.
- Nessuna icona - la funzione viene mostrata senza icona.
- Un'icona - qualsiasi icona della libreria comune o delle tue icone.
- Set - l'icona dipende dal valore della funzione: si usa la prima riga il cui valore «fino a» non è minore del valore, l'ultima riga vale per tutti i valori maggiori. Con «Giorno / notte» ogni riga ha la propria icona notturna, usata tra il tramonto e l'alba.
Valori per i set: batteria - carica in %, sveglie - il loro numero, connessione del telefono e non disturbare - 1 o 0, luna - età in giorni, vento - direzione in gradi, meteo - codice di condizione; altre funzioni - il loro numero senza unità. Durante la ricarica le icone della batteria vengono mostrate a turno.
L'impostazione Mostra di un elemento sceglie testo e icona, solo testo o solo icona. Posizione dell'icona rispetto al testo, dimensione, colore, distanza e spostamento si impostano nel layout di ogni modello. L'allineamento dell'elemento si applica all'intero blocco: testo, spaziatura e icona insieme.
Le tue icone si aggiungono nella scheda Quadrante, sezione Icone del quadrante: file SVG (anche più di uno alla volta) o un font TTF, ogni carattere del quale diventa un'icona. Requisiti per gli SVG:
- le icone sono monocromatiche: i colori del file vengono ignorati, l'icona è disegnata con il colore scelto nel designer;
- si usano solo forme piene; le linee senza riempimento (stroke) vanno convertite in forme in un editor vettoriale (ad esempio «Da contorno a tracciato» in Inkscape o «Outline Stroke» in Figma e Illustrator);
- i fori devono essere veri ritagli (tracciato composto o regola di riempimento evenodd): una forma bianca sopra una nera diventa un'area piena;
- la dimensione dell'icona è il viewBox del file; sfumature, maschere, testo e classi CSS non sono supportati.
Sull'orologio le icone vengono convertite in bitmap della dimensione necessaria durante la compilazione del quadrante.
Font e immagini
- I font di sistema dell'orologio sono disponibili per ogni modello. I font numerici contengono solo cifre e pochi simboli.
- I tuoi font TTF o OTF si caricano nella scheda Quadrante e vengono convertiti in bitmap per ogni modello e dimensione. Un modello può avere fino a 12 dimensioni diverse di font e icone propri in tutto.
- Le immagini (PNG, JPEG, GIF, WebP fino a 2000×2000) si caricano nella stessa scheda. Un'immagine riempie lo schermo di qualsiasi modello oppure ha una dimensione propria; viene ridimensionata per ogni modello, la trasparenza viene mantenuta. Fino a 8 immagini o dimensioni diverse per modello.
- Le immagini occupano la memoria grafica dell'orologio; il designer mostra quanta ne viene usata sul modello attuale.
Modalità Always On
Sugli schermi AMOLED in modalità Always On il quadrante mostra solo gli elementi con l'opzione Mostra in modalità Always On, su sfondo nero e con un piccolo spostamento ogni minuto per proteggere lo schermo. Garmin consente al massimo il 10% di pixel accesi in questa modalità; il designer mostra questo valore sopra lo schermo. Secondi e lancetta dei secondi non vengono mostrati in questa modalità.
Compilazione
- Compila per questo orologio (.prg) - file per il modello attuale da installare sul tuo orologio.
- Compila per Connect IQ Store (.iq) - pacchetto per tutti i modelli selezionati da pubblicare nel Connect IQ Store. Ogni compilazione .iq riceve un nuovo numero di versione.
Le compilazioni vengono messe in coda e di solito richiedono circa un minuto. La scheda Compilazioni mostra lo stato, il link per il download e il registro di compilazione.
L'UUID dell'app nella scheda Quadrante identifica l'app nello store. Non modificarlo tra le versioni. Per aggiornare un'app già pubblicata, inserisci il suo UUID.
Installare un file .prg sull'orologio
Collega l'orologio al computer con il cavo USB e copia il file .prg nella cartella GARMIN/Apps dell'orologio. Dopo aver scollegato il cavo, il quadrante appare nell'elenco dei quadranti dell'orologio.
- Windows: l'orologio appare in Esplora file come dispositivo (ad esempio "fēnix 7"). Apri Internal Storage → GARMIN → Apps e copia lì il file.
- macOS: la maggior parte degli orologi moderni si collega tramite MTP, che macOS non supporta senza software aggiuntivo. Installa OpenMTP (gratuito), collega l'orologio, apri GARMIN/Apps e copia lì il file. Prima chiudi Garmin Express, altrimenti prende il controllo della connessione.
- Linux: l'orologio appare nel file manager (GNOME Files, Dolphin) come dispositivo MTP; apri GARMIN/Apps e copia lì il file. Senza ambiente grafico l'orologio può essere montato con jmtpfs o simple-mtpfs.
Per rimuovere il quadrante, elimina il file da GARMIN/Apps o rimuovilo sull'orologio.
Nota: le impostazioni di un quadrante installato in questo modo non possono essere modificate nell'app Garmin Connect, usa le impostazioni predefinite. Per provare le impostazioni, pubblica il quadrante nello store come app beta.
Pubblicazione nel Connect IQ Store
Il designer non carica file nello store. Accedi alla dashboard sviluppatore di Connect IQ (apps.garmin.com/developer), crea un'app di tipo "watch face", carica il file .iq, aggiungi una descrizione e gli screenshot e invia l'app per la revisione.
Per aggiornare l'app, compila un nuovo file .iq (la sua versione aumenta automaticamente) e caricalo come nuova versione della stessa app. L'UUID e la chiave sviluppatore devono restare gli stessi.
API
Panoramica
L'API PayToUse esegue le seguenti funzioni:
- Controlla lo stato di attivazione di un codice di sblocco e lo attiva se necessario.
- Recupera i dati della glicemia dall'app NightScout.
- Recupera i dati meteorologici attuali per una posizione specificata.
Tutte le informazioni possono essere richieste e restituite in una singola richiesta.
Endpoint API
Puoi utilizzare uno dei seguenti endpoint:
- https://api.pay-to-use.com
- https://api.p2u.io
Entrambi gli endpoint gestiscono richieste GET e POST.
Parametri della richiesta
- device: stringa (obbligatorio) — identificatore univoco del dispositivo
- app: intero (obbligatorio) — il tuo ID applicazione
- model: stringa (opzionale) — codice del modello di dispositivo, necessario per raccogliere e visualizzare le statistiche per i dispositivi che utilizzano l'app
- code: stringa (opzionale) — codice di sblocco
- bg: array associativo (opzionale) — dati per richiedere i livelli di glicemia dall'app NightScout
- url: stringa (opzionale) — indirizzo dell'app NightScout
- weather: array associativo (opzionale) — dati per richiedere le condizioni meteorologiche attuali
- appid: stringa (opzionale) — chiave di accesso dell'API meteorologica
- lat: float (opzionale) — latitudine
- lon: float (opzionale) — longitudine
- provider: intero (opzionale) — provider meteorologico
Elenco dei provider meteorologici supportati
1. OpenWeatherMap
- Descrizione: OpenWeatherMap fornisce dati meteorologici a livello globale, tra cui condizioni meteorologiche in tempo reale, dati storici e previsioni a 16 giorni. Grazie all'ampia copertura geografica e agli aggiornamenti frequenti, OpenWeatherMap è una scelta molto diffusa per le applicazioni che richiedono sia dati meteorologici aggiornati che previsioni a lungo termine.
- Dati forniti: Temperatura, umidità, velocità del vento, qualità dell'aria, probabilità di precipitazioni e altro ancora, in tempo reale. Fornisce sia dati attuali che previsioni, compresi i dati meteorologici minuto per minuto per alcune località selezionate.
- Selezione del provider: Inserisci provider = 1 nella sezione weather della tua richiesta per selezionare OpenWeatherMap come fornitore di dati meteorologici.
- Note sull'utilizzo: Offre piani gratuiti e a pagamento, con accesso ai dati tramite autenticazione tramite chiave API. I piani a pagamento includono livelli di dati avanzati e funzionalità premium.
- One Call API 3.0: L’indice UV è disponibile solo con una chiave abbonata a One Call API 3.0 (un abbonamento separato nel tuo account OpenWeatherMap). Con una tale chiave, una sola richiesta One Call sostituisce le richieste separate di meteo attuale e previsioni. Se One Call rifiuta la chiave, viene usata l’API gratuita 2.5 e One Call viene ritentato dopo un giorno.
- Documentazione API: Disponibile qui.
2. QWeather
- Descrizione: QWeather, noto anche come HeWeather, fornisce dati meteorologici completi incentrati sulla Cina, ma include anche dati internazionali. Offre informazioni dettagliate quali condizioni meteorologiche in tempo reale, previsioni, dati sulla qualità dell'aria e avvisi.
- Dati forniti: Temperatura attuale, umidità, indice UV, livelli di inquinamento, previsioni giornaliere e orarie, nonché avvisi relativi a condizioni meteorologiche avverse. È noto per i suoi dati dettagliati sulla qualità dell'aria e per gli aggiornamenti in tempo reale sulle variazioni delle condizioni meteorologiche.
- Selezione del provider: Inserisci provider = 2 nella sezione weather della tua richiesta per selezionare QWeather come fornitore di dati meteorologici.
- Note sull'utilizzo: QWeather offre l'accesso tramite API con un piano gratuito e uno premium. Il piano gratuito fornisce dati limitati, mentre le opzioni premium consentono di accedere a ulteriori dati e località.
- Documentazione API: Disponibile qui.
3. MET Weather (MET Norway)
- Descrizione: L'API MET Weather, fornita da MET Norway, offre accesso a una vasta gamma di dati meteorologici aperti, tra cui previsioni, dati storici e dati specifici relativi alla Norvegia e alle regioni nordiche. Rinomata per la sua accuratezza e trasparenza, MET Weather è la soluzione ideale per le applicazioni che richiedono dati meteorologici altamente affidabili.
- Dati forniti: Condizioni meteorologiche attuali, previsioni, precipitazioni, temperatura, dati sul vento e indice UV. MET Weather offre dati specifici per le regioni nordiche, ma fornisce anche informazioni meteorologiche a livello globale.
- Selezione del provider: Inserisci provider = 3 nella sezione weather della tua richiesta per selezionare MET Weather come fornitore di dati meteorologici.
- Note sull'utilizzo: Tutti i dati forniti da MET Weather sono disponibili gratuitamente per l'uso in base a una licenza Creative Commons, che consente applicazioni sia a scopo non commerciale che commerciale senza alcun costo. MET Norway è rinomata per i suoi dati ambientali, il che la rende un fornitore affidabile, in particolare in Europa.
- Documentazione API: Disponibile qui.
Esempio di richiesta
function onTemporalEvent() as Void {
var ds = System.getDeviceSettings();
if (!ds.phoneConnected) { // Verifica che il dispositivo sia collegato al telefono per l'invio della richiesta
return;
}
var id = ds.uniqueIdentifier;
if (id == null) { // Verifica che al dispositivo sia stato assegnato un identificatore univoco
return;
}
var request = {};
var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
if (lockCheck == null || lockCheck <= Time.now().value()) { // Invia il codice se necessario
request.put("code", Application.Properties.getValue("UnlockCode"));
}
var ns_url = Application.Properties.getValue("NS");
if (!ns_url.equals("")) { // Se necessario, invia l'URL dell'app NightScout
request.put("bg", { "url" => ns_url });
}
var wP = Application.Properties.getValue("Weather");
if (wP != 0) { // Invia i parametri della richiesta meteo, se necessario
var lat = Application.Properties.getValue("latitude");
var lon = Application.Properties.getValue("longitude");
if (!lat.equals("") && !lon.equals("")) {
request.put("weather", {
"appid" => Application.Properties.getValue("appID"),
"lat" => lat,
"lon" => lon,
"provider" => wP
});
}
}
if (!request.isEmpty()) {
// Compila i parametri di richiesta obbligatori
request.put("device", id);
request.put("app", p2uAppID); // ID della tua applicazione
request.put("model", ds.partNumber);
Toybox.Communications.makeWebRequest(
"https://api.p2u.io", // Endpoint API
request,
{
:method => 3, // Communications.HTTP_REQUEST_METHOD_POST
:headers => {
"Content-Type" => 1 // Communications.REQUEST_CONTENT_TYPE_JSON
},
:responseType => 0 // Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
},
method(:onReceive)
);
}
}
Risposta dell'API
L'API restituisce un oggetto JSON contenente informazioni sullo stato di sblocco, sul livello di glucosio e sulle condizioni meteorologiche.
Parametri della risposta
Risultati della verifica del codice di sblocco (se è stata inviata una richiesta):
- response: intero — codice di ritorno
- msg: stringa — messaggio relativo al risultato della verifica
- code: stringa — il codice di sblocco a cui si riferisce il risultato, se noto
- expires: intero — timestamp di scadenza del codice in formato UNIXTIMESTAMP
- qr: array — Codice QR per l'acquisto o la verifica del numero di serie, se del caso
Risposta dell'app NightScout (se è stata inviata una richiesta):
- bg: array associativo — risposta formattata dall'app NightScout
- value: intero — livello di glucosio nel sangue in mg/dL
- date: intero — data e ora di scadenza del codice in formato UNIXTIMESTAMP
- direction: stringa — andamento della variazione del livello di glucosio nel sangue
Risposta dell'API meteo (se è stata inviata una richiesta):
- weather: array associativo — risposta formattata dall'API meteo
- provider: intero — identificativo del fornitore di dati meteorologici
- weather: array — condizioni meteorologiche attuali. Può restituire uno o due valori; se vengono restituiti due valori, questi rappresentano le condizioni diurne e notturne
- temp: float — temperatura attuale in gradi Celsius
- feels_like: float — temperatura percepita in gradi Celsius
- pressure: intero — pressione atmosferica in hPa
- humidity: intero — umidità in %
- precipitation: intero — probabilità di precipitazioni in %
Per MET Weather, solo nei paesi nordici. -1 se il valore non è disponibile. - wind: intero — direzione del vento in gradi
- wind_speed: float — velocità del vento in m/s
- wind_gust: float — velocità delle raffiche di vento in m/s
Non disponibile per QWeather. Per MET Weather, solo nei paesi nordici. -1 se il valore non è disponibile. - uvi: float — indice UV
Per OpenWeatherMap, solo con una chiave abbonata a One Call API 3.0. Per QWeather, il massimo giornaliero. Per MET Weather, l’indice UV a cielo sereno. -1 se il valore non è disponibile. - temp_low: float — la temperatura minima odierna in gradi Celsius
- temp_high: float — la temperatura massima odierna in gradi Celsius
- sunrise_today: intero — l’ora dell'alba di oggi in formato UNIXTIMESTAMP
- sunset_today: intero — l’ora del tramonto di oggi in formato UNIXTIMESTAMP
- sunrise_tomorrow: intero — l’ora dell'alba di domani in formato UNIXTIMESTAMP
- sunset_tomorrow: intero — l’ora del tramonto di domani in formato UNIXTIMESTAMP
- aqi: array associativo — indice di qualità dell'aria
- level: intero — livello dell'indice di qualità dell'aria
- value: intero — valore dell'indice di qualità dell'aria
Esempio di risposta
{
"response": 103,
"msg": "Free for beta tester",
"expires": 0,
"qr": [
"11111110111011010110101111111",
"10000010111001001101001000001",
"10111010101100110110101011101",
"10111010110101000001001011101",
"10111010000001010100001011101",
"10000010100110001101001000001",
"11111110101010101010101111111",
"00000000010010110111100000000",
"11001110000100100100100101111",
"11111100011011011010011111111",
"01111011100111111100101000001",
"01111100101100110111011011011",
"00110110101010100101110000010",
"11001000010001011000001011111",
"01101010001001110100000001101",
"10111101100010100101100110011",
"01010111111100110100100100010",
"10000100111011011000101111011",
"00000110110110110100100000101",
"00111100011100001100101100011",
"11110111110010100111111111001",
"00000000111001011101100010001",
"11111110010001011111101011101",
"10000010100010100111100010010",
"10111010101101100111111111001",
"10111010010010110000010000001",
"10111010001111111110000001111",
"10000010111101011111101101011",
"11111110100011011110110010010"
],
"bg": {
"value": -102,
"date": 1730546101,
"direction": ""
},
"weather": {
"provider": 1,
"weather": [
89
],
"temp": 0.27,
"feels_like": -3.14,
"pressure": 999,
"humidity": 78,
"precipitation": 0,
"wind": 120,
"wind_speed": 2.96,
"wind_gust": 5.21,
"uvi": 0.4,
"temp_low": -3.8,
"temp_high": 0.27,
"sunrise_today": 1730527969,
"sunset_today": 1730551770,
"sunrise_tomorrow": 1730614492,
"sunset_tomorrow": 1730638051,
"aqi": {
"level": 1,
"value": 38
}
}
}
Codici di risposta
Il campo response del risultato della verifica del codice di sblocco assume uno dei seguenti valori. Esempi di risposta e l'ordine dei controlli sono descritti in Controlli sul lato API.
| Codice | Descrizione |
|---|---|
| 101 | Il codice è valido. L'applicazione può essere sbloccata. |
| 102 | Nessun codice valido, ma il periodo di prova non è ancora scaduto. L'applicazione può essere sbloccata fino alla data nel campo expires. |
| 103 | Nessun codice valido, ma il dispositivo è un beta tester: la sua prima chiamata all'API è avvenuta prima della data nel campo Data di rilascio dell'applicazione. L'applicazione può essere sbloccata fino alla data nel campo expires (0 - senza limite). |
| 201 | Il codice non è stato trovato o è stato eliminato. |
| 202 | Il codice è già attivato su un altro dispositivo. |
| 203 | Il codice è scaduto. |
| 204 | Il periodo di prova è scaduto e non è stato inviato un codice valido. |
| 301 | L'applicazione non è stata trovata o non è disponibile. |
| 302 | La durata del codice non è definita. |
| 303 | Parametri insufficienti nella richiesta. |
| 304 | Per questa applicazione è richiesto l'identificatore del dispositivo. |
| 401 | Errore durante il salvataggio del codice. Scrivi al supporto all'indirizzo [email protected]. |
| 402 | Errore durante il salvataggio del dispositivo. Scrivi al supporto all'indirizzo [email protected]. |
| 500 | Errore sconosciuto. Scrivi al supporto all'indirizzo [email protected]. |
I codici 1xx indicano che l'applicazione può essere sbloccata, 2xx - che deve rimanere bloccata, 3xx - un errore nella richiesta, 4xx e 5xx - un errore da parte di PayToUse. In caso di errori 4xx e 5xx, si consiglia di mantenere l'ultimo risultato positivo e di ripetere la richiesta più tardi.
Se nelle impostazioni dell'applicazione è attivata l'opzione Consenti il reinvio del codice tramite ID dispositivo, la richiesta contiene un identificatore del dispositivo ma nessun codice, e a questo dispositivo è già collegato un codice valido, l'API restituisce 101 insieme a questo codice nel campo code. L'applicazione può salvarlo e non chiedere più all'utente di inserirlo.
Note
- Le richieste con bg richiedono una connessione all'app NightScout.
- Per ogni richiesta contenente code, l'API verifica automaticamente lo stato del codice e lo attiva se è inattivo.
- Si prega di tenere presente che i parametri dell'API potrebbero essere aggiornati o modificati nel tempo al fine di migliorarne la funzionalità, la compatibilità e la sicurezza. Si raccomanda di consultare periodicamente la documentazione dell'API per verificare l'eventuale presenza di modifiche che potrebbero influire sull'integrazione o sull'utilizzo.
Fornitori meteo
Di seguito la corrispondenza tra le condizioni meteo restituite nel campo weather e i valori di ciascun fornitore.
Garmin
Per una descrizione dettagliata delle funzioni e delle costanti meteorologiche dell'SDK Garmin, consultare questo link. È possibile memorizzare i valori ottenuti dall'API o i risultati delle funzioni meteorologiche dell'SDK Garmin, a seconda del fornitore di dati meteorologici selezionato, per garantire la coerenza nella visualizzazione dei valori sullo schermo.
| ID | Descrizione | Giorno | Notte |
|---|---|---|---|
| 0 | Cielo sereno |
0x53 |
0x54 |
| 40 | Bel tempo | ||
| 23 | Prevalentemente sereno |
0x55 |
0x56 |
| 1 | Parzialmente nuvoloso |
0x57 |
0x58 |
| 22 | Parzialmente sereno | ||
| 2 | Prevalentemente nuvoloso |
0x59 |
|
| 52 | Nuvole sottili | ||
| 20 | Nuvoloso |
0x5A |
|
| 45 | Cielo nuvoloso con possibilità di pioggia | ||
| 31 | Pioggerella |
0x3E |
|
| 14 | Pioggia debole |
0x42 |
|
| 24 | Rovesci leggeri | ||
| 3 | Pioggia |
0x43 |
|
| 25 | Rovesci | ||
| 27 | Possibilità di rovesci |
0x46 |
|
| 11 | Rovesci sparsi | ||
| 15 | Pioggia intensa | ||
| 26 | Forti rovesci | ||
| 28 | Possibilità di temporali |
0x36 |
0x37 |
| 12 | Temporali sparsi |
0x38 |
|
| 6 | Temporali |
0x39 |
|
| 8 | Nebbia |
0x4E |
|
| 9 | Cielo velato | ||
| 29 | Foschia | ||
| 39 | Caligine | ||
| 30 | Polvere |
0x4F |
|
| 35 | Sabbia | ||
| 33 | Fumo | ||
| 38 | Cenere vulcanica | ||
| 37 | Tempesta di sabbia | ||
| 13 | Precipitazioni | ||
| 5 | Ventoso |
0x52 |
|
| 36 | Raffica | ||
| 48 | Deboli nevicate | ||
| 32 | Tornado |
0x50 |
|
| 41 | Uragano | ||
| 42 | Tempesta tropicale | ||
| 50 | Nevischio |
0x45 |
|
| 7 | Misto invernale | ||
| 18 | Pioggia leggera e neve | ||
| 19 | Forti piogge e nevicate | ||
| 21 | Pioggia e neve | ||
| 49 | Pioggia gelata | ||
| 44 | Possibilità di pioggia o neve | ||
| 47 | Cielo nuvoloso con possibilità di pioggia o neve | ||
| 34 | Ghiaccio | ||
| 51 | Ghiaccio e neve | ||
| 43 | Possibilità di neve |
0x4C |
0x4D |
| 16 | Neve leggera | ||
| 46 | Cielo nuvoloso con possibilità di neve |
0x4A |
|
| 4 | Neve | ||
| 17 | Forti nevicate |
0x4B |
|
| 10 | Grandine |
0x3A |
|
Open Weather Map
Guarda come esempio il set di icone di OpenWeatherMap qui.
| ID | Descrizione | Giorno | Notte |
|---|---|---|---|
| 2xx | Temporale | ||
| 200 | Temporale con pioggia leggera |
0x36 |
0x37 |
| 201 | Temporale con pioggia |
0x38 |
|
| 202 | Temporale con pioggia intensa | ||
| 210 | Temporale leggero | ||
| 211 | Temporale |
0x39 |
|
| 212 | Forte temporale |
0x3B |
|
| 221 | Temporale irregolare | ||
| 230 | Temporale con pioggerella leggera |
0x3A |
|
| 231 | Temporale con pioggerella | ||
| 232 | Temporale con pioggerella intensa | ||
| 3xx | Pioggerella | ||
| 300 | Pioggerellina leggera |
0x3C |
0x3D |
| 301 | Pioggerella |
0x3E |
|
| 302 | Pioggerella intensa |
0x3F |
|
| 310 | Pioggerella leggera e pioggia |
0x40 |
|
| 311 | Pioggerella e pioggia | ||
| 312 | Pioggerella intensa e pioggia |
0x41 |
|
| 313 | Rovesci e pioggerella | ||
| 314 | Forti rovesci e pioggerella | ||
| 321 | Rovesci di pioggerella | ||
| 5xx | Pioggia | ||
| 500 | Pioggia debole |
0x42 |
|
| 501 | Pioggia moderata |
0x43 |
|
| 502 | Pioggia intensa |
0x44 |
|
| 503 | Pioggia molto intensa | ||
| 504 | Pioggia estrema | ||
| 511 | Pioggia gelata |
0x45 |
|
| 520 | Rovesci leggeri |
0x46 |
|
| 521 | Rovesci | ||
| 522 | Rovesci intensi | ||
| 531 | Rovesci irregolari | ||
| 6xx | Neve | ||
| 600 | Neve leggera |
0x4C |
0x4D |
| 601 | Neve |
0x4A |
|
| 602 | Forti nevicate | ||
| 611 | Nevischio |
0x45 |
|
| 612 | Rovesci leggeri di nevischio | ||
| 613 | Rovesci di nevischio | ||
| 615 | Pioggia leggera e neve | ||
| 616 | Pioggia e neve | ||
| 620 | Rovesci di neve leggeri |
0x4B |
|
| 621 | Rovesci di neve | ||
| 622 | Forti rovesci di neve | ||
| 7xx | Atmosfera | ||
| 701 | Foschia |
0x4E |
|
| 711 | Fumo |
0x4F |
|
| 721 | Caligine | ||
| 731 | Vortici di sabbia/polvere | ||
| 741 | Nebbia | ||
| 751 | Sabbia |
0x4F |
|
| 761 | Polvere | ||
| 762 | Cenere vulcanica | ||
| 771 | Groppi |
0x52 |
|
| 781 | Tornado |
0x50 |
|
| 800 | Cielo sereno | ||
| 800 | Cielo sereno |
0x53 |
0x54 |
| 80x | Nuvolosità | ||
| 801 | Poco nuvoloso 11–25% |
0x55 |
0x56 |
| 802 | Nuvolosità sparsa 25–50% |
0x57 |
0x58 |
| 803 | Molto nuvoloso 51–84% |
0x59 |
|
| 804 | Coperto 85–100% |
0x5A |
|
QWeather
Puoi vedere il set originale di icone meteo cliccando qui
| ID | Descrizione | Giorno | Notte |
|---|---|---|---|
| 302 | Temporale con rovesci |
0x36 |
0x37 |
| 303 | Forte temporale |
0x38 |
|
| 310 | Nubifragio |
0x39 |
|
| 317 | Da nubifragio a forte nubifragio | ||
| 304 | Grandine |
0x3A |
|
| 311 | Forte nubifragio |
0x3B |
|
| 312 | Nubifragio molto forte | ||
| 318 | Nubifragio da forte a molto forte | ||
| 309 | Pioggerella |
0x3C |
0x3D |
| 404 | Nevischio |
0x3E |
|
| 305 | Pioggia leggera |
0x42 |
|
| 314 | Pioggia da leggera a moderata | ||
| 306 | Pioggia moderata |
0x43 |
|
| 315 | Pioggia da moderata a forte | ||
| 399 | Pioggia | ||
| 308 | Pioggia estrema |
0x44 |
|
| 316 | Da pioggia forte a nubifragio | ||
| 313 | Pioggia gelata |
0x45 |
|
| 405 | Pioggia e neve | ||
| 300 | Rovesci |
0x46 |
|
| 301 | Forti rovesci | ||
| 307 | Pioggia forte | ||
| 350 | Rovesci | ||
| 351 | Forti rovesci | ||
| 400 | Neve leggera |
0x4C |
0x4D |
| 408 | Neve da leggera a moderata | ||
| 499 | Neve | ||
| 401 | Neve moderata |
0x4A |
|
| 402 | Forte nevicata | ||
| 409 | Neve da moderata a forte | ||
| 410 | Da forti nevicate a tempesta di neve | ||
| 403 | Tempesta di neve |
0x4B |
|
| 406 | Rovesci di pioggia e neve | ||
| 407 | Rovesci di neve | ||
| 456 | Rovesci di pioggia e neve | ||
| 457 | Rovesci di neve | ||
| 503 | Sabbia |
0x4E |
|
| 504 | Polvere | ||
| 507 | Tempesta di polvere | ||
| 508 | Tempesta di sabbia | ||
| 511 | Foschia moderata | ||
| 512 | Foschia intensa | ||
| 513 | Foschia molto intensa | ||
| 500 | Foschia |
0x4F |
|
| 501 | Nebbia | ||
| 502 | Caligine | ||
| 509 | Nebbia densa | ||
| 510 | Nebbia fitta | ||
| 514 | Nebbia molto fitta | ||
| 515 | Nebbia estremamente fitta | ||
| 100 | Soleggiato |
0x53 |
0x54 |
| 150 | Cielo sereno | ||
| 101 | Nuvoloso |
0x55 |
0x56 |
| 151 | Nuvoloso | ||
| 102 | Poche nuvole |
0x57 |
0x58 |
| 152 | Poche nuvole | ||
| 103 | Parzialmente nuvoloso |
0x59 |
|
| 153 | Parzialmente nuvoloso | ||
| 104 | Coperto |
0x5A |
|
MET Weather
Guarda come esempio il set di icone di MET Weather qui.
| ID | Descrizione | Giorno | Notte |
|---|---|---|---|
| lightrainshowers | Rovesci leggeri |
0x36 |
0x37 |
| lightrainshowersandthunder | Rovesci leggeri e tuoni | ||
| rainshowersandthunder | Rovesci e tuoni | ||
| heavyrainshowersandthunder | Forti rovesci e tuoni | ||
| heavyrainandthunder | Pioggia battente e tuoni |
0x38 |
|
| rainandthunder | Pioggia e tuoni | ||
| lightrainandthunder | Pioggia leggera e tuoni |
0x39 |
|
| heavysleetandthunder | Forte nevischio e tuoni |
0x3B |
|
| lightsleetandthunder | Nevischio leggero e tuoni |
0x3A |
|
| lightssleetshowersandthunder | Rovesci leggeri di nevischio e tuoni | ||
| sleetandthunder | Nevischio e tuoni | ||
| lightsleetshowers | Rovesci leggeri di nevischio |
0x3C |
0x3D |
| sleetshowers | Rovesci di nevischio | ||
| sleetshowersandthunder | Rovesci di nevischio e tuoni | ||
| heavysleetshowers | Forti rovesci di nevischio | ||
| heavysleetshowersandthunder | Forti rovesci di nevischio e tuoni | ||
| lightsleet | Nevischio leggero |
0x3E |
|
| sleet | Nevischio |
0x3F |
|
| heavysleet | Nevischio intenso |
0x45 |
|
| lightrain | Pioggia debole |
0x42 |
|
| rain | Pioggia |
0x43 |
|
| heavyrain | Pioggia intensa |
0x44 |
|
| rainshowers | Rovesci |
0x46 |
|
| heavyrainshowers | Forti rovesci | ||
| heavysnow | Forti nevicate |
0x4B |
|
| heavysnowandthunder | Forti nevicate e tuoni | ||
| snow | Neve | ||
| snowandthunder | Neve e tuoni | ||
| lightsnowshowers | Rovesci di neve leggeri |
0x4C |
0x4D |
| lightssnowshowersandthunder | Leggeri rovesci di neve e tuoni | ||
| snowshowers | Rovesci di neve | ||
| snowshowersandthunder | Rovesci di neve e tuoni | ||
| heavysnowshowers | Forti rovesci di neve | ||
| heavysnowshowersandthunder | Forti rovesci di neve e tuoni | ||
| lightsnow | Neve leggera |
0x4A |
|
| lightsnowandthunder | Neve leggera e tuoni | ||
| fog | Nebbia |
0x4F |
|
| clearsky | Cielo sereno |
0x53 |
0x54 |
| fair | Bel tempo |
0x55 |
0x56 |
| partlycloudy | Parzialmente nuvoloso |
0x57 |
0x58 |
| cloudy | Nuvoloso |
0x59 |
|