Documentazione MDM
Kioskys supporta la configurazione gestita (Managed App Configuration). Il tuo MDM consegna all'app un plist di chiavi; ogni chiave che imposti vince su quanto l'utente ha scritto e l'utente non può modificarla. Tutte le chiavi sono facoltative.
Cosa serve
- Un iPad supervisionato iscritto al tuo MDM (necessario per la Modalità App Singola).
- Kioskys acquistata in volume in Apple Business Manager (app a pagamento, assegnata ai tuoi dispositivi o utenti) e installata dall'MDM come app gestita: la configurazione viene consegnata solo alle app gestite.
- Il Bundle ID dell'app: app.consulenza.kioskys (è lo stesso per tutti, non va cambiato).
Chiavi
| Chiave | Tipo | Valori | Cosa fa |
|---|---|---|---|
kioskURL | stringa | indirizzo | Il sito del kiosk. Senza schema aggiunge https:// (http:// per IP e rete locale). |
autoStartSeconds | intero | 0, oppure 3–120 | Secondi del conto alla rovescia all'avvio. 0 = nessuna schermata di impostazioni, il kiosk parte subito. Predefinito 10. |
settingsPIN | stringa | 4–8 cifre | PIN che protegge le impostazioni. L'utente non può cambiarlo né toglierlo. Va scritto come stringa per non perdere gli zeri iniziali. |
allowUserConfiguration | booleano | true / false | false = la schermata delle impostazioni è di sola lettura. Predefinito true. |
allowedHosts | array di stringhe | nomi di host | Domini extra verso cui la pagina può navigare (per esempio un login esterno). Solo nomi di host, niente schema né percorsi. |
allowCamera | booleano | true / false | Concede la fotocamera alle pagine del sito configurato. Predefinito true. |
allowLocation | booleano | true / false | Concede la posizione. Se false, navigator.geolocation risponde «negato». Predefinito true. |
staleReloadMinutes | intero | 0–1440 | Minuti in background dopo i quali la pagina si ricarica al ritorno. 0 = mai. Predefinito 0 (spento). |
orientation | stringa | auto, portrait, landscape | Blocco dell'orientamento (verticale e orizzontale ammettono anche il capovolgimento di 180°). Predefinito auto. |
energySaverEnabled | booleano | true / false | Risparmio energetico: dopo i minuti impostati senza tocchi la luminosità scende a energySaverBrightness (predefinita 5%); un tocco la riporta al 100%. Predefinito true. |
energySaverMinutes | intero | 1–120 | Minuti senza tocchi prima di abbassare la luminosità. Predefinito 5. |
deviceName | stringa | 1–80 caratteri | Nome del dispositivo, visibile alle pagine come window.Kioskys.deviceName. |
openingHours | dizionario | mon … sun, daily | Orari di apertura. Ogni giorno è "HH:mm-HH:mm", "24h" o "closed"; i giorni non indicati sono chiusi, salvo daily. Dizionario vuoto = sempre aperto. Chiusura prima dell'apertura = aperto oltre la mezzanotte. |
closedMessage | stringa | fino a 200 caratteri | Testo mostrato nella schermata di chiusura. |
idleResetSeconds | intero | 0, oppure 10–3600 | Dopo questi secondi senza tocchi (o tasti premuti) il kiosk torna alla prima pagina. 0 = spento. Predefinito spento. |
idleResetClearData | booleano | true / false | Al ripristino cancella anche cookie e dati del sito. Predefinito true. |
playlist | array di dizionari | type, url, seconds, muted | Modalità playlist: pagine, foto e video a rotazione, in ciclo (fino a 50). type: page, image o video; seconds: 3–3600 (0 per un video = fino alla fine); muted: true toglie l'audio a un video. Foto e video si scaricano e si salvano nell'iPad, quindi partono senza attese. Sostituisce kioskURL. Array vuoto = kiosk classico. |
closedBrightness | intero | 0–100 | Luminosità dello schermo da chiuso (percentuale). Predefinito 5. |
closedMedia | dizionario | type, url | Una foto o un video mostrati da chiuso: {type: image o video, url}. Viene scaricato e salvato nell'iPad; il video si ripete. Dizionario vuoto = schermata di chiusura standard. |
bridgeEnabled | booleano | true / false | Il ponte JavaScript (window.Kioskys.scan, beep). Predefinito true. |
disablePageZoom | booleano | true / false | Blocca lo zoom della pagina: pizzico, doppio tocco e viewport della pagina. Predefinito true. |
scannerCamera | stringa | front, back | Fotocamera usata da Kioskys.scan(). Predefinito front. |
energySaverBrightness | intero | 0–100 | Luminosità dello schermo (percentuale) quando il Risparmio energetico lo ha scurito. Predefinito 5. Alzala se usi uno screensaver. |
screensaverEnabled | booleano | true / false | Screensaver: mentre il Risparmio energetico ha scurito lo schermo, al posto del kiosk si vede una foto o un video; un tocco riporta il kiosk. Non ha timer né luminosità propri. Predefinito spento (si accende da solo se invii screensaverMedia senza questa chiave). |
screensaverMedia | dizionario | type, url | Foto o video dello screensaver: {type: image o video, url}. Si scarica e si salva nell'iPad; un video si ripete, senza audio. Dizionario vuoto = nessun contenuto (lo screensaver non parte). |
customCSS | stringa | fino a 100.000 caratteri | CSS aggiunto a ogni pagina del sito del kiosk (e dei domini di allowedHosts), non alle pagine di terzi a cui il sito reindirizza. Si applica prima che la pagina compaia. |
customJS | stringa | fino a 100.000 caratteri | JavaScript eseguito su ogni pagina del sito del kiosk (e dei domini di allowedHosts) a pagina caricata; è disponibile window.Kioskys. Gli errori vanno nella console della pagina. Con customJS è l'MDM a decidere cosa gira nel kiosk: scrivilo come il codice del tuo sito. |
Da sapere
- Numeri e booleani inviati come stringhe ("10", "true") sono accettati. I valori non validi vengono ignorati e segnalati: non rompono mai l'app.
- Il settingsPIN è in chiaro nel profilo (lo vedono gli amministratori dell'MDM). L'app non lo salva sul dispositivo.
- Le modifiche fatte nell'MDM si applicano ad app aperta; un nuovo indirizzo ricarica la pagina.
- L'app restituisce il proprio stato in com.apple.feedback.managed (versione, indirizzo, pagina caricata, stato dei permessi di fotocamera e posizione, segnalazioni sulla configurazione).
- Kioskys tiene l'iPad acceso mentre è in primo piano. Per impedire di uscire dall'app usa la Modalità App Singola.
- Cinque tocchi rapidi nell'angolo in alto a sinistra riaprono le impostazioni (in sola lettura se allowUserConfiguration è false; se c'è un settingsPIN viene chiesto prima).
- Le stesse chiavi funzionano anche senza MDM: la pagina Configuratore QR le trasforma in un codice QR che copia le impostazioni su un iPad. Ciò che imposta un MDM vince sempre e l'utente non può cambiarlo.
File pronti
I profili hanno già il Bundle ID app.consulenza.kioskys. Rigenera i loro UUID (uuidgen) prima dell'uso.
- Configurazione app (tutte le chiavi)
- Profilo Modalità App Singola (l'MDM blocca l'iPad su Kioskys)
- Profilo Modalità App Singola Autonoma (l'app si blocca da sola)
Configurazione di esempio
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<!--
Kioskys - configurazione gestita (Managed App Configuration)
Incolla questo dizionario nel campo "App Configuration" / "Configurazione app" del tuo MDM, per l'app con
Bundle ID app.consulenza.kioskys. Tutte le chiavi sono facoltative: lascia solo quelle che ti servono.
Se una chiave e' presente, vince su quanto l'utente ha impostato a mano e l'utente non puo' cambiarla.
-->
<plist version="1.0">
<dict>
<!-- Indirizzo del kiosk. Senza schema si aggiunge https:// (http:// per IP e rete locale). -->
<key>kioskURL</key>
<string>https://example.org/kiosk</string>
<!-- Secondi di conto alla rovescia all'avvio: 0 = nessuna schermata, il kiosk parte subito; altrimenti 3-120. -->
<key>autoStartSeconds</key>
<integer>0</integer>
<!-- PIN che protegge le impostazioni (stringa di 4-8 cifre). L'utente non puo' cambiarlo ne' toglierlo.
Attenzione: nel profilo e' in chiaro (lo vede chi amministra l'MDM). Non e' salvato sul dispositivo. -->
<key>settingsPIN</key>
<string>4821</string>
<!-- false = la schermata delle impostazioni e' di sola lettura (niente modifiche locali). Predefinito: true. -->
<key>allowUserConfiguration</key>
<true/>
<!-- Domini extra verso cui la pagina puo' navigare (es. un login esterno). Solo nomi di host, niente https:// ne' percorsi. -->
<key>allowedHosts</key>
<array>
<string>login.example.com</string>
</array>
<!-- Fotocamera e posizione concesse alle pagine del sito configurato. Predefinito: true. -->
<key>allowCamera</key>
<true/>
<key>allowLocation</key>
<true/>
<!-- Minuti in background dopo i quali la pagina viene ricaricata al ritorno (0 = mai). Predefinito: 0. -->
<key>staleReloadMinutes</key>
<integer>0</integer>
<!-- Blocco dell'orientamento dello schermo: auto (libero), portrait (verticale) o landscape (orizzontale).
Verticale e orizzontale ammettono anche il capovolgimento di 180 gradi. Predefinito: auto. -->
<key>orientation</key>
<string>landscape</string>
<!-- Energy Saver: dopo energySaverMinutes senza tocchi la luminosita' scende a energySaverBrightness (predefinita 5%); al tocco torna al 100%.
Predefinito: attivo, 5 minuti. Minuti: da 1 a 120. Luminosita': da 0 a 100. -->
<key>energySaverEnabled</key>
<true/>
<key>energySaverMinutes</key>
<integer>5</integer>
<key>energySaverBrightness</key>
<integer>30</integer>
<!-- Nome del dispositivo, visibile alle pagine come window.Kioskys.deviceName (max 80 caratteri). -->
<key>deviceName</key>
<string>iPad Magazzino 1</string>
<!-- Orari di apertura: mon..sun (oppure daily) come "HH:mm-HH:mm", "24h" o "closed". I giorni non indicati sono chiusi, salvo daily.
Un dizionario vuoto = sempre aperto. Fuori orario il kiosk mostra una schermata di chiusura a luminosita' minima. -->
<key>openingHours</key>
<dict>
<key>daily</key>
<string>08:00-20:00</string>
<key>sun</key>
<string>closed</string>
</dict>
<key>closedMessage</key>
<string>Siamo chiusi. A domani!</string>
<!-- Schermata di chiusura: luminosita' in percentuale (predefinita 5) e, se vuoi, una foto o un video che vengono scaricati e salvati nell'iPad.
Con <dict/> si ha la schermata di chiusura standard (luna e messaggio). -->
<key>closedBrightness</key>
<integer>40</integer>
<key>closedMedia</key>
<dict>
<key>type</key><string>image</string>
<key>url</key><string>https://example.org/chiuso.jpg</string>
</dict>
<!-- Ripristino per inattivita': dopo questi secondi senza tocchi il kiosk torna alla prima pagina (0 = spento; 10-3600). -->
<key>idleResetSeconds</key>
<integer>120</integer>
<key>idleResetClearData</key>
<true/>
<!-- Playlist: pagine, foto e video a rotazione, in ciclo (fino a 50). Se presente sostituisce kioskURL; array vuoto = nessuna playlist.
seconds: 3-3600; per un video 0 = fino alla fine. -->
<key>playlist</key>
<array>
<dict>
<key>type</key><string>page</string>
<key>url</key><string>https://example.org/menu</string>
<key>seconds</key><integer>30</integer>
</dict>
<dict>
<key>type</key><string>image</string>
<key>url</key><string>https://example.org/offerta.jpg</string>
<key>seconds</key><integer>10</integer>
</dict>
<dict>
<key>type</key><string>video</string>
<key>url</key><string>https://example.org/promo.mp4</string>
<key>seconds</key><integer>0</integer>
<key>muted</key><true/>
</dict>
</array>
<!-- Ponte JavaScript (window.Kioskys.scan / beep) e fotocamera dello scanner: front o back. -->
<key>bridgeEnabled</key>
<true/>
<!-- Blocca lo zoom della pagina: pizzico, doppio tocco e viewport della pagina. Predefinito: true. -->
<key>disablePageZoom</key>
<true/>
<key>scannerCamera</key>
<string>front</string>
<!-- Screensaver: mentre l'Energy Saver ha scurito lo schermo (energySaverMinutes/energySaverBrightness) si vede questa foto o questo video; un tocco riporta al kiosk. Nessun timer proprio. -->
<key>screensaverEnabled</key>
<true/>
<key>screensaverMedia</key>
<dict>
<key>type</key><string>video</string>
<key>url</key><string>https://example.org/screensaver.mp4</string>
</dict>
<!-- CSS e JavaScript personalizzati, applicati alle pagine del sito del kiosk (non a pagine di terzi). Fino a 100000 caratteri ciascuno. -->
<key>customCSS</key>
<string>.cookie-banner { display: none !important; }</string>
<key>customJS</key>
<string>document.documentElement.classList.add('kiosk');</string>
</dict>
</plist>