Kioskys

MDM-dokumentasjon

Kioskys støtter administrert appkonfigurasjon (Managed App Configuration). MDM-løsningen din leverer en plist med nøkler til appen; hver nøkkel du angir, går foran det brukeren har skrevet, og brukeren kan ikke endre den. Alle nøkler er valgfrie.

Dette trenger du

Nøkler

NøkkelTypeVerdierHva den gjør
kioskURLstrengadresseKiosk-nettstedet. Uten skjema legges https:// til (http:// for IP-adresser og lokalt nettverk).
autoStartSecondsheltall0, eller 3–120Sekunder for nedtellingen ved oppstart. 0 = ingen innstillingsskjerm, kiosken starter umiddelbart. Standard 10.
settingsPINstreng4–8 sifrePIN-kode som beskytter innstillingene. Brukeren kan ikke endre eller fjerne den. Skriv den som en streng for å beholde innledende nuller.
allowUserConfigurationboolsktrue / falsefalse = innstillingsskjermen er skrivebeskyttet. Standard true.
allowedHostsarray av strengervertsnavnEkstra domener siden kan navigere til (for eksempel en ekstern innlogging). Bare vertsnavn, uten skjema eller sti.
allowCameraboolsktrue / falseGir sidene på det konfigurerte nettstedet tilgang til kameraet. Standard true.
allowLocationboolsktrue / falseGir tilgang til posisjonen. Ved false svarer navigator.geolocation «denied». Standard true.
staleReloadMinutesheltall0–1440Minutter i bakgrunnen etter som siden lastes på nytt ved retur. 0 = aldri. Standard 0 (av).
orientationstrengauto, portrait, landscapeOrienteringslås (portrait og landscape tillater også 180°-vending). Standard auto.
energySaverEnabledboolsktrue / falseStrømsparing: etter de angitte minuttene uten berøring dimmes skjermen til 5 %; en berøring gjenoppretter 100 %. Standard true.
energySaverMinutesheltall1–120Minutter uten berøring før skjermen dimmes. Standard 5.
deviceNamestreng1–80 tegnEnhetsnavn, synlig for sider som window.Kioskys.deviceName.
openingHoursdictionarymon … sun, dailyÅpningstider. Hver dag er "HH:mm-HH:mm", "24h" eller "closed"; dager som ikke er oppgitt, er stengt med mindre daily er angitt. Tom dictionary = alltid åpent. Stenging før åpning = åpent etter midnatt.
closedMessagestrengopptil 200 tegnTekst som vises på stengt-skjermen.
idleResetSecondsheltall0, eller 10–3600Etter så mange sekunder uten berøring (eller tastetrykk) går kiosken tilbake til første side. 0 = av. Standard av.
idleResetClearDataboolsktrue / falseSletter også informasjonskapsler og nettstedsdata ved tilbakestilling. Standard true.
playlistarray av dictionariestype, url, seconds, mutedSpillelistemodus: sider, bilder og videoer etter tur i en løkke (opptil 50). type: page, image eller video; seconds: 3–3600 (0 for en video = til slutten); muted: true demper en video. Bilder og videoer lastes ned og lagres på iPad-en, så de spilles uten forsinkelse. Erstatter kioskURL. Tom array = klassisk kiosk.
closedBrightnessheltall0–100Skjermens lysstyrke når det er stengt (prosent). Standard 5.
closedMediadictionarytype, urlEt bilde eller en video som vises når det er stengt: {type: image eller video, url}. Det lastes ned og lagres på iPad-en; en video gjentas. Tom dictionary = standard stengt-skjerm.
bridgeEnabledboolsktrue / falseJavaScript-broen (window.Kioskys.scan, beep). Standard true.
disablePageZoomboolsktrue / falseBlokkerer sidezoom: klyping, dobbelttrykk og sidens viewport. Standard true.
scannerCamerastrengfront, backKamera som brukes av Kioskys.scan(). Standard front.
energySaverBrightnessheltall0–100Skjermens lysstyrke (prosent) når strømsparing har dempet skjermen. Standard 5. Øk den hvis du bruker en skjermsparer.
screensaverEnabledboolsktrue / falseSkjermsparer: når strømsparing demper skjermen, vises et bilde eller en video i stedet for kiosken; en berøring bringer kiosken tilbake. Den har ingen egen tidtaker eller lysstyrke. Standard av (slås på av seg selv hvis du sender screensaverMedia uten denne nøkkelen).
screensaverMediadictionarytype, urlSkjermsparerens bilde eller video: {type: image eller video, url}. Lastes ned og lagres på iPaden; en video gjentas, uten lyd. Tom dictionary = ikke noe innhold (skjermspareren starter ikke).
customCSSstreng≤ 100 000CSS som legges til på hver side på kiosknettstedet (og på domenene i allowedHosts), ikke på tredjepartssider som nettstedet omdirigerer til. Brukes før siden vises.
customJSstreng≤ 100 000JavaScript som kjøres på hver side på kiosknettstedet (og på domenene i allowedHosts) når den er lastet; window.Kioskys er tilgjengelig. Feil havner i sidens konsoll. Med customJS bestemmer MDM-en din hva som kjører i kiosken: skriv det som koden på ditt eget nettsted.

Greit å vite

Ferdige filer

Profilene har allerede Bundle ID app.consulenza.kioskys. Opprett nye UUID-er (uuidgen) før bruk. Kommentarene i filene er på engelsk.

Eksempelkonfigurasjon

<?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 - Managed App Configuration
  Paste this dictionary into the "App Configuration" field of your MDM, for the app with the Bundle ID
  app.consulenza.kioskys. All keys are optional: keep only the ones you need.
  A key that is present wins over what the user set by hand, and the user cannot change it.
-->
<plist version="1.0">
<dict>
	<!-- Kiosk address. Without a scheme https:// is added (http:// for IPs and local network). -->
	<key>kioskURL</key>
	<string>https://example.org/kiosk</string>

	<!-- Seconds of the start countdown: 0 = no settings screen, the kiosk starts immediately; otherwise 3-120. -->
	<key>autoStartSeconds</key>
	<integer>0</integer>

	<!-- PIN protecting the settings (string of 4-8 digits). The user cannot change or remove it.
	     Note: it is in clear text inside the profile (MDM administrators can see it). It is not stored on the device. -->
	<key>settingsPIN</key>
	<string>4821</string>

	<!-- false = the settings screen is read-only (no local changes). Default: true. -->
	<key>allowUserConfiguration</key>
	<true/>

	<!-- Extra domains the page may navigate to (e.g. an external login). Host names only, no https:// and no paths. -->
	<key>allowedHosts</key>
	<array>
		<string>login.example.com</string>
	</array>

	<!-- Camera and location granted to the pages of the configured site. Default: true. -->
	<key>allowCamera</key>
	<true/>
	<key>allowLocation</key>
	<true/>

	<!-- Minutes in the background after which the page reloads on return (0 = never). Default: 0. -->
	<key>staleReloadMinutes</key>
	<integer>0</integer>

	<!-- Screen orientation lock: auto (free), portrait or landscape.
	     Portrait and landscape also allow the 180-degree flip. Default: auto. -->
	<key>orientation</key>
	<string>landscape</string>

	<!-- Energy Saver: after energySaverMinutes without touches the brightness drops to energySaverBrightness (default 5%); a touch restores 100%.
	     Default: on, 5 minutes. Minutes: 1 to 120. Brightness: 0 to 100. -->
	<key>energySaverEnabled</key>
	<true/>
	<key>energySaverMinutes</key>
	<integer>5</integer>
	<key>energySaverBrightness</key>
	<integer>30</integer>

	<!-- Device name, visible to pages as window.Kioskys.deviceName (max 80 characters). -->
	<key>deviceName</key>
	<string>Warehouse iPad 1</string>
	<!-- Opening hours: mon..sun (or daily) as "HH:mm-HH:mm", "24h" or "closed". Days not listed are closed unless daily is given.
	     An empty dictionary means always open. Outside the hours the kiosk shows a closed screen at minimum brightness. -->
	<key>openingHours</key>
	<dict>
		<key>daily</key>
		<string>08:00-20:00</string>
		<key>sun</key>
		<string>closed</string>
	</dict>
	<key>closedMessage</key>
	<string>We are closed. See you tomorrow!</string>
	<!-- Closed screen: brightness in percent (default 5) and an optional photo or video that is downloaded and saved on the iPad.
	     Use <dict/> for the standard closed screen (moon and message). -->
	<key>closedBrightness</key>
	<integer>40</integer>
	<key>closedMedia</key>
	<dict>
		<key>type</key><string>image</string>
		<key>url</key><string>https://example.org/closed.jpg</string>
	</dict>
	<!-- Inactivity reset: after this many seconds without touches the kiosk returns to its first page (0 = off; 10-3600). -->
	<key>idleResetSeconds</key>
	<integer>120</integer>
	<key>idleResetClearData</key>
	<true/>
	<!-- Playlist: pages, photos and videos shown in turn, in a loop (up to 50). It replaces kioskURL when present; an empty array = no playlist.
	     seconds: 3-3600; for a video 0 means "until it ends". -->
	<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/offer.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>
	<!-- JavaScript bridge (window.Kioskys.scan / beep) and the camera used for scanning: front or back. -->
	<key>bridgeEnabled</key>
	<true/>
	<!-- Blocks page zoom: pinch, double-tap and the page's own viewport. Default: true. -->
	<key>disablePageZoom</key>
	<true/>
	<key>scannerCamera</key>
	<string>front</string>
	<!-- Screensaver: while the Energy Saver has dimmed the screen (energySaverMinutes/energySaverBrightness) this photo or video is shown; a touch brings the kiosk back. It has no timer of its own. -->
	<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>
	<!-- Custom CSS and JavaScript, applied to the pages of the kiosk site (not to third-party pages). Up to 100000 characters each. -->
	<key>customCSS</key>
	<string>.cookie-banner { display: none !important; }</string>
	<key>customJS</key>
	<string>document.documentElement.classList.add('kiosk');</string>
</dict>
</plist>