Kioskys

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

Chiavi

ChiaveTipoValoriCosa fa
kioskURLstringaindirizzoIl sito del kiosk. Senza schema aggiunge https:// (http:// per IP e rete locale).
autoStartSecondsintero0, oppure 3–120Secondi del conto alla rovescia all'avvio. 0 = nessuna schermata di impostazioni, il kiosk parte subito. Predefinito 10.
settingsPINstringa4–8 cifrePIN che protegge le impostazioni. L'utente non può cambiarlo né toglierlo. Va scritto come stringa per non perdere gli zeri iniziali.
allowUserConfigurationbooleanotrue / falsefalse = la schermata delle impostazioni è di sola lettura. Predefinito true.
allowedHostsarray di stringhenomi di hostDomini extra verso cui la pagina può navigare (per esempio un login esterno). Solo nomi di host, niente schema né percorsi.
allowCamerabooleanotrue / falseConcede la fotocamera alle pagine del sito configurato. Predefinito true.
allowLocationbooleanotrue / falseConcede la posizione. Se false, navigator.geolocation risponde «negato». Predefinito true.
staleReloadMinutesintero0–1440Minuti in background dopo i quali la pagina si ricarica al ritorno. 0 = mai. Predefinito 0 (spento).
orientationstringaauto, portrait, landscapeBlocco dell'orientamento (verticale e orizzontale ammettono anche il capovolgimento di 180°). Predefinito auto.
energySaverEnabledbooleanotrue / falseRisparmio energetico: dopo i minuti impostati senza tocchi la luminosità scende a energySaverBrightness (predefinita 5%); un tocco la riporta al 100%. Predefinito true.
energySaverMinutesintero1–120Minuti senza tocchi prima di abbassare la luminosità. Predefinito 5.
deviceNamestringa1–80 caratteriNome del dispositivo, visibile alle pagine come window.Kioskys.deviceName.
openingHoursdizionariomon … sun, dailyOrari 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.
closedMessagestringafino a 200 caratteriTesto mostrato nella schermata di chiusura.
idleResetSecondsintero0, oppure 10–3600Dopo questi secondi senza tocchi (o tasti premuti) il kiosk torna alla prima pagina. 0 = spento. Predefinito spento.
idleResetClearDatabooleanotrue / falseAl ripristino cancella anche cookie e dati del sito. Predefinito true.
playlistarray di dizionaritype, url, seconds, mutedModalità 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.
closedBrightnessintero0–100Luminosità dello schermo da chiuso (percentuale). Predefinito 5.
closedMediadizionariotype, urlUna 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.
bridgeEnabledbooleanotrue / falseIl ponte JavaScript (window.Kioskys.scan, beep). Predefinito true.
disablePageZoombooleanotrue / falseBlocca lo zoom della pagina: pizzico, doppio tocco e viewport della pagina. Predefinito true.
scannerCamerastringafront, backFotocamera usata da Kioskys.scan(). Predefinito front.
energySaverBrightnessintero0–100Luminosità dello schermo (percentuale) quando il Risparmio energetico lo ha scurito. Predefinito 5. Alzala se usi uno screensaver.
screensaverEnabledbooleanotrue / falseScreensaver: 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).
screensaverMediadizionariotype, urlFoto 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).
customCSSstringafino a 100.000 caratteriCSS 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.
customJSstringafino a 100.000 caratteriJavaScript 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

File pronti

I profili hanno già il Bundle ID app.consulenza.kioskys. Rigenera i loro UUID (uuidgen) prima dell'uso.

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>