MDM दस्तावेज़ीकरण
Kioskys मैनेज्ड ऐप कॉन्फ़िगरेशन (Managed App Configuration) का समर्थन करता है। आपका MDM ऐप को कुंजियों का एक plist देता है; आपकी तय की हुई हर कुंजी उपयोगकर्ता के लिखे पर भारी पड़ती है और उपयोगकर्ता उसे बदल नहीं सकता। सभी कुंजियाँ वैकल्पिक हैं।
क्या चाहिए
- आपके MDM में नामांकित एक सुपरवाइज़्ड iPad (सिंगल ऐप मोड के लिए ज़रूरी)।
- Apple Business Manager में थोक में ख़रीदा गया Kioskys (सशुल्क ऐप, आपके डिवाइस या उपयोगकर्ताओं को असाइन किया हुआ) और MDM द्वारा मैनेज्ड ऐप के रूप में इंस्टॉल किया गया: कॉन्फ़िगरेशन केवल मैनेज्ड ऐप्स को मिलता है।
- ऐप का Bundle ID: app.consulenza.kioskys (सबके लिए एक ही है, बदलने की ज़रूरत नहीं)।
कुंजियाँ
| कुंजी | प्रकार | मान | यह क्या करती है |
|---|---|---|---|
kioskURL | स्ट्रिंग | पता | किओस्क की साइट। स्कीम न हो तो https:// जोड़ा जाता है (IP और लोकल नेटवर्क के लिए http://)। |
autoStartSeconds | पूर्णांक | 0, या 3–120 | शुरू होने पर उलटी गिनती के सेकंड। 0 = सेटिंग्स स्क्रीन नहीं, किओस्क तुरंत शुरू होता है। डिफ़ॉल्ट 10। |
settingsPIN | स्ट्रिंग | 4–8 अंक | सेटिंग्स की रक्षा करने वाला PIN। उपयोगकर्ता इसे बदल या हटा नहीं सकता। शुरुआती शून्य बनाए रखने के लिए इसे स्ट्रिंग की तरह लिखें। |
allowUserConfiguration | बूलियन | true / false | false = सेटिंग्स स्क्रीन केवल पढ़ने के लिए। डिफ़ॉल्ट true। |
allowedHosts | स्ट्रिंग की ऐरे | होस्ट नाम | अतिरिक्त डोमेन जहाँ पेज जा सकता है (जैसे बाहरी लॉगिन)। केवल होस्ट नाम, स्कीम या पथ नहीं। |
allowCamera | बूलियन | true / false | कॉन्फ़िगर की गई साइट के पेजों को कैमरा देता है। डिफ़ॉल्ट true। |
allowLocation | बूलियन | true / false | लोकेशन की अनुमति देता है। false हो तो navigator.geolocation "अस्वीकृत" जवाब देता है। डिफ़ॉल्ट true। |
staleReloadMinutes | पूर्णांक | 0–1440 | बैकग्राउंड में इतने मिनट रहने के बाद लौटने पर पेज रीलोड होता है। 0 = कभी नहीं। डिफ़ॉल्ट 0 (बंद)। |
orientation | स्ट्रिंग | auto, portrait, landscape | ओरिएंटेशन लॉक (पोर्ट्रेट और लैंडस्केप में 180° पलटना भी संभव)। डिफ़ॉल्ट auto। |
energySaverEnabled | बूलियन | true / false | ऊर्जा बचत: तय मिनटों तक बिना छुए रहने पर स्क्रीन की चमक 5% हो जाती है; छूने पर 100%। डिफ़ॉल्ट true। |
energySaverMinutes | पूर्णांक | 1–120 | चमक घटाने से पहले बिना छुए मिनट। डिफ़ॉल्ट 5। |
deviceName | स्ट्रिंग | 1–80 अक्षर | डिवाइस का नाम, पेजों को window.Kioskys.deviceName के रूप में दिखता है। |
openingHours | डिक्शनरी | mon … sun, daily | खुलने का समय। हर दिन "HH:mm-HH:mm", "24h" या "closed" होता है; बताए न गए दिन बंद माने जाते हैं, daily दिया हो तो वही। ख़ाली डिक्शनरी = हमेशा खुला। बंद होने का समय खुलने से पहले हो तो आधी रात के बाद तक खुला। |
closedMessage | स्ट्रिंग | 200 अक्षर तक | बंद स्क्रीन पर दिखने वाला पाठ। |
idleResetSeconds | पूर्णांक | 0, या 10–3600 | इतने सेकंड बिना छुए (या बिना कुंजी दबाए) रहने पर किओस्क पहले पेज पर लौट आता है। 0 = बंद। डिफ़ॉल्ट बंद। |
idleResetClearData | बूलियन | true / false | रीसेट पर कुकी और साइट डेटा भी मिटाता है। डिफ़ॉल्ट true। |
playlist | डिक्शनरी की ऐरे | type, url, seconds, muted | प्लेलिस्ट मोड: पेज, फ़ोटो और वीडियो बारी-बारी से, लूप में (50 तक)। type: page, image या video; seconds: 3–3600 (वीडियो के लिए 0 = अंत तक); muted: true वीडियो की आवाज़ बंद करता है। फ़ोटो और वीडियो डाउनलोड होकर iPad पर सेव होते हैं, इसलिए बिना देरी चलते हैं। kioskURL की जगह लेता है। ख़ाली ऐरे = क्लासिक किओस्क। |
closedBrightness | पूर्णांक | 0–100 | बंद रहने के दौरान स्क्रीन की चमक (प्रतिशत)। डिफ़ॉल्ट 5। |
closedMedia | डिक्शनरी | type, url | बंद रहने के दौरान दिखने वाली फ़ोटो या वीडियो: {type: image या video, url}। यह डाउनलोड होकर iPad पर सेव होता है; वीडियो दोहराया जाता है। ख़ाली डिक्शनरी = मानक बंद स्क्रीन। |
bridgeEnabled | बूलियन | true / false | JavaScript ब्रिज (window.Kioskys.scan, beep)। डिफ़ॉल्ट true। |
disablePageZoom | बूलियन | true / false | पेज का ज़ूम रोकता है: पिंच, डबल-टैप और पेज का अपना viewport। डिफ़ॉल्ट true। |
scannerCamera | स्ट्रिंग | front, back | Kioskys.scan() जिस कैमरे का उपयोग करता है। डिफ़ॉल्ट front। |
energySaverBrightness | पूर्णांक | 0–100 | ऊर्जा बचत द्वारा स्क्रीन मंद किए जाने पर स्क्रीन की चमक (प्रतिशत)। डिफ़ॉल्ट 5। स्क्रीनसेवर इस्तेमाल करते हैं तो इसे बढ़ाएँ। |
screensaverEnabled | बूलियन | true / false | स्क्रीनसेवर: जब ऊर्जा बचत स्क्रीन को मंद करती है, तब कियोस्क की जगह कोई फ़ोटो या वीडियो दिखता है; स्क्रीन छूने पर कियोस्क लौट आता है। इसका अपना टाइमर या चमक नहीं है। डिफ़ॉल्ट बंद (इस कुंजी के बिना screensaverMedia भेजने पर यह अपने आप चालू हो जाता है)। |
screensaverMedia | डिक्शनरी | type, url | स्क्रीनसेवर की फ़ोटो या वीडियो: {type: image या video, url}। इसे डाउनलोड करके iPad पर सहेजा जाता है; वीडियो बिना आवाज़ के दोहराया जाता है। खाली डिक्शनरी = कोई सामग्री नहीं (स्क्रीनसेवर शुरू नहीं होता)। |
customCSS | स्ट्रिंग | ≤ 100 000 | कियोस्क साइट के हर पेज (और allowedHosts के डोमेन) में जोड़ा जाने वाला CSS; उन तृतीय-पक्ष पेजों में नहीं जहाँ साइट रीडायरेक्ट करती है। पेज दिखने से पहले लागू होता है। |
customJS | स्ट्रिंग | ≤ 100 000 | कियोस्क साइट के हर पेज (और allowedHosts के डोमेन) के लोड होने के बाद चलने वाला JavaScript; window.Kioskys उपलब्ध है। त्रुटियाँ पेज के कंसोल में जाती हैं। customJS के साथ आपका MDM तय करता है कि कियोस्क में क्या चलेगा: इसे अपनी साइट के कोड की तरह लिखें। |
जानने योग्य बातें
- स्ट्रिंग के रूप में भेजे गए संख्या और बूलियन ("10", "true") स्वीकार किए जाते हैं। अमान्य मान नज़रअंदाज़ होकर रिपोर्ट किए जाते हैं, ऐप को कभी नहीं बिगाड़ते।
- settingsPIN प्रोफ़ाइल में सादे पाठ में होता है (MDM के प्रशासक इसे देख सकते हैं)। ऐप इसे डिवाइस पर सेव नहीं करता।
- MDM में किए बदलाव ऐप खुला होने पर लागू होते हैं; नया पता पेज को रीलोड करता है।
- ऐप अपनी स्थिति com.apple.feedback.managed में भेजता है (संस्करण, पता, पेज लोड हुआ या नहीं, कैमरा और लोकेशन अनुमति की स्थिति, कॉन्फ़िगरेशन की समस्याएँ)।
- Kioskys फ़ोरग्राउंड में रहते हुए iPad को जगाए रखता है। लोगों को ऐप से बाहर जाने से रोकने के लिए सिंगल ऐप मोड का उपयोग करें।
- ऊपर-बाएँ कोने में पाँच तेज़ टैप सेटिंग्स दोबारा खोलते हैं (allowUserConfiguration false हो तो केवल पढ़ने के लिए; settingsPIN हो तो पहले वही पूछा जाता है)।
- यही कुंजियाँ बिना MDM के भी काम करती हैं: QR सेटअप पेज उन्हें QR कोड में बदल देता है जो सेटिंग्स iPad पर कॉपी करता है। MDM जो तय करता है वह हमेशा भारी पड़ता है और उपयोगकर्ता उसे बदल नहीं सकता।
तैयार फ़ाइलें
प्रोफ़ाइल में पहले से Bundle ID app.consulenza.kioskys है। उपयोग से पहले उनके UUID (uuidgen) दोबारा बनाएँ। फ़ाइलों की टिप्पणियाँ अंग्रेज़ी में हैं।
- ऐप कॉन्फ़िगरेशन (सभी कुंजियाँ)
- सिंगल ऐप मोड प्रोफ़ाइल (MDM iPad को Kioskys पर लॉक करता है)
- ऑटोनॉमस सिंगल ऐप मोड प्रोफ़ाइल (ऐप ख़ुद को लॉक करता है)
उदाहरण कॉन्फ़िगरेशन
<?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>