Az iBooks Author támogatja a HTML5 formátumú (.wdgt kiterjesztésű) widgeteket.
Az iBooks Author alkalmazáshoz használható HTML widget készítéséhez egy szövegszerkesztő vagy webtartalom-készítő alkalmazással hozza létre a következő fájlokat:
- Fő HTML-fájl: Ez a fájl a widget fő része. Bármilyen nevet adhat neki, de a „.html” kiterjesztést kell használnia. A fő HTML-fájlban elhelyezhet CSS- vagy JavaScript-tartalmat, vagy felvehet .css és .js kiterjesztésű fájlokat a widgetcsomagba, és beállíthatja, hogy a fő HTML-fájl betöltse őket. Ezekben a fájlokban használhat bármilyen technikát vagy trükköt, amelyet a weblapok tervezésekor szokott. Általánosságban elmondható, hogy a HTML-kóddal definiálhatja a widget szerkezetét, a CSS-kóddal határozhatja meg a megjelenítés stílusát, és a JavaScript-kóddal biztosíthatja az interaktív funkciókat.
- Default.png: Ez az a kép, amely a lapon megjelenik, és amelyre a felhasználóknak rá kell koppintaniuk a widget megnyitásához. Követelmény, hogy a neve „Default.png” legyen, nagy „D” kezdőbetűvel. A Default.png fájlt a legegyszerűbben úgy hozhatja létre, hogy képernyőképet készít a fő HTML-fájlról egy webtartalom-készítő alkalmazásban vagy böngészőben. Amikor a widget aktív, a mérete megegyezik a Default.png kép méretével, hacsak más méretet nem adott meg az Info.plist fájlban.
- Info.plist: Ez a fájl tartalmazza azokat az információkat, amelyekre az iBooks Author és az iBooks alkalmazásnak szüksége van a widget futtatásához. Követelmény, hogy a neve „Info.plist” legyen. Részleteket és mintát alább talál.
Miután létrehozta a három kötelező fájlt (illetve esetleg néhány további fájlt, például CSS-t vagy JavaScriptet), foglalja őket egy widgetcsomagba:
- A Finderben hozzon létre egy mappát, és helyezze el benne a fájlokat.
- Nevezze át a mappát, és fűzze hozzá a mappanévhez a .wdgt kiterjesztést. Ezzel létrejön egy widgetcsomag, és a mappaikon widgetikonná változik.
A widgetet ezt követően felveheti az iBooks Author alkalmazásba.
Megjegyzések
- Ha a könyv olyan HTML-widgeteket tartalmaz, amelyek esetén a fájlnevekben vezérlőkarakterek találhatók, akkor a könyv nem tehető közzé az iBooks Store áruházban. Mielőtt létrehoz egy saját widgetcsomagot, ügyeljen arra, hogy a csomagban található fájlok egyikének a nevében se szerepeljen ilyen karakter. Ne használjon egyedi mappaikonokat.
- Ne helyezzen a widgetcsomagba olyan mappát, amelynek a neve a következők egyike:
- Resources/
- Support Files/Resources/
- Contents/Resources/
- Ha Retina kijelzős iPad készülékhez vagy Mac számítógéphez készít tartalmat:
- A HTML-, CSS- és JavaScript-fájlok kódjának megírásakor kövesse a Retina (2x) grafikájú webhelyek létrehozására vonatkozó szabványos protokollt.
- A widgetcsomagnak tartalmaznia kell egy Default@2x.png fájlt, amelynek a felbontása kétszerese a Default.png fájlénak. Ez a fájl nem lesz látható az iBooks Author alkalmazásban, de megjelenik az iBooks alkalmazásban a Retina kijelzős iPad készüléken, illetve a Mac számítógépeken.
- Ha azt szeretné, hogy a widget a teljes képernyőt elfoglalja az iPad készüléken való nagyításkor, a Default.png fájlt 768 x 1024 képpont felbontásúra, a Default@2x.png fájlt pedig 1536 x 2048 képpont felbontásúra állítsa. Ha a widgetet a teljes képernyősnél kisebb méretben szeretné megjeleníteni, állítsa a Default.png fájlt akkora méretűre, amekkorában meg szeretné jeleníteni (például 600 x 900 képpont), a Default@2x.png fájlt pedig kétszer ekkora méretre állítsa.
- Ez a cikk azt ismerteti, hogy az iBooks Author alkalmazással létrehozott könyvek hogyan optimalizálhatók.
Az Info.plist fájl
Egy egyszerű widget Info.plist fájlja bizonyos kötelező kulcsokat és néhány opcionális kulcsot tartalmaz. Ezeket a kulcsokat az alábbiakban ismertetjük a definíciójukkal és néhány, egy „Helló világ” elnevezésű widgetre vonatkozó példaértékkel együtt.
| Kulcs | Példaérték | Definíció |
| CFBundleDevelopmentRegion | Angol | Nem kötelező. A csomag készítésének régióját megadó karakterlánc. Általában megegyezik a csomagot létrehozó személy által beszélt nyelvvel. |
| CFBundleDisplayName | Helló világ | Kötelező. A widget iBooks Author és iBooks alkalmazásban ténylegesen megjelenítendő nevét tartalmazó karakterlánc. |
| CFBundleIdentifier | hu.apple.widget.HelloVilag | Kötelező. A widgetet egyedileg azonosító karakterlánc fordított tartománynév-formátumban. |
| CFBundleName | Helló világ | Nem kötelező. A widget nevét tartalmazó karakterlánc. A .wdgt fájlkiterjesztéstől eltekintve meg kell egyeznie a widgetcsomag Finderben látható nevével. |
| CFBundleShortVersionString | 1.0 | Nem kötelező. A widget rövidített verziószámát megadó karakterlánc. Sokszor azonos a CFBundleVersion értékével. |
| CFBundleVersion | 1.0 | Nem kötelező. A widget verziószámát megadó karakterlánc. |
| Height | 768 | Nem kötelező. A widget magasságát képpontokban megadó szám. Ha nincs megadva, a rendszer Default.png fájl magasságát használja. |
| MainHTML | HelloVilag.html | Kötelező. A widget megvalósítását tartalmazó HTML-fájl nevét megadó karakterlánc. |
| Width | 1024 | Nem kötelező. A widget szélességét képpontokban megadó szám. Ha nincs megadva, a rendszer Default.png fájl szélességét használja. |
| IBNotifiesOnReady | <true/> | Nem kötelező. Ha értéke true (igaz), akkor a widget szabályozza, hogy az iBooks mikor váltson át a Default.png megjelenítéséről a futó HTML widget megjelenítésére. |
Egy widget teljes Info.plist fájlja a következőképpen néz ki:
<?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"><plist version="1.0"><dict> <key>CFBundleDevelopmentRegion</key> <string>Hungarian</string> <key>CFBundleDisplayName</key> <string>Helló világ</string> <key>CFBundleIdentifier</key> <string>hu.apple.widget.HelloVilag</string> <key>CFBundleName</key> <string>Helló világ</string> <key>CFBundleShortVersionString</key> <string>1.0</string> <key>CFBundleVersion</key> <string>1.0</string> <key>Height</key> <integer>768</integer> <key>MainHTML</key> <string>HelloVilag.html</string> <key>Width</key> <integer>1024</integer> <key>IBNotifiesOnReady</key> <true/></dict></plist>
Korlátozások
Bizonyos funkciók nem kompatibilisek. Ne használja a következő kulcsokat:
| Kulcs | Leírás |
| AllowFileAccessOutsideOfWidget | Az iBooks Author alkalmazással létrehozott könyvekben található widgetek nem férnek hozzá az általános fájlrendszerben lévő fájlokhoz. |
| AllowFullAccess | További olyan hozzáférési kulcsok összefoglaló megnevezése, amelyek egy része nem kompatibilis. |
| AllowInternetPlugins | Az internetes bővítmények, például a Flash, nem érhetők el az iBooks Author alkalmazással létrehozott könyvekben. Filmek és hanganyag a HTML5 <video> és <audio> elemével foglalhatók a könyvekbe. Megjegyzés: A HTML widgetekben található filmek és hanganyagok nem rendelkeznek digitális másolásvédelemmel (DRM). |
| AllowJava | Az iBooks Author alkalmazással létrehozott könyvekben található widgetek nem rendelkezhetnek Java-tartalommal. |
| AllowSystem | Az iBooks Author alkalmazással létrehozott könyvekben található widgetek nem férhetnek hozzá a rendszerparancsokhoz. |
| Plugin | Az iBooks Author alkalmazással létrehozott könyvekben található widgetek nem rendelkezhetnek Cocoa-bővítmény összetevővel. |
Az iBooks Author figyelmen kívül hagyja az alábbi kulcsokat:
| Kulcs | Leírás |
| CloseBoxInsetX | Az iBooks Author és az iBooks widgetjei nem jelenítenek meg bezárási díszítést. |
| CloseBoxInsetY |
|
| Fonts | Az iBooks Author widgetjei nem használnak csomagba foglalt betűtípusokat. |
Filmekre és hanganyagokra vonatkozó követelmények
Nem használhatók „.m4v” vagy „.m4p” kiterjesztésű médiafájlok.
MPEG-4 formátumú tárolóba foglalt H.264 kódolású, „.mp4” fájlkiterjesztésű videoanyag használata javasolt.
A hanglejátszáshoz MPEG-4 formátumú tárolóba foglalt AAC kódolású, „.m4a” fájlkiterjesztésű hanganyag használata javasolt.
Megjegyzés: A HTML widgetcsomagokban található video- és hanganyagok nem rendelkeznek digitális másolásvédelemmel (DRM).
Megjegyzés: Bizonyos esetekben előfordul, hogy a HTML widgetekben található filmek és hangfájlok nem játszhatók le az iBooks Author alkalmazásban, csak az iBooks alkalmazásban. Ha nem tud lejátszani egy widgetben lévő filmet vagy hangfájlt az iBooks Author alkalmazásban, tekintse meg előnézetben iPad készüléken vagy OS X Mavericks rendszerű számítógépen. Ezzel megtudhatja, hogy fog lejátszódni a fájl a kész könyvben.
Honosítás
A honosított karakterláncokat és erőforrásokat nem támogatja az iBooks Author. Ezért a felhasználónak megjelenített szöveges karakterláncokat beágyazva kell a könyvbe foglalni a célnyelven.
Levágott szélű elemek
Ha egy elem – például <video> – egyik oldala nem látszik, azt az okozhatja, hogy nagyobb területet tölt ki, mint amely látható. Ellenőrizze a „width:auto” CSS-paramétert a #video választóban, és módosítsa a tényleges méret szerint. Ha például a widget egy 960 x 540 képpont méretű videót tartalmaz, akkor keresse meg a CSS-ben a vonatkozó választót, és állítsa be explicit módon a megfelelő szélességet és magasságot:
#video { width: 960; height: 540;}Fejlesztés egyszerre iOS és OS X Mavericks rendszerre
Az iOS és az OS X alapvetően eltérő bemeneti típusokat használnak, így ha saját HTML-widgeteket hoz létre az iBooks Author alkalmazáshoz, ügyeljen arra, hogy mind egérrel, mind érintéssel használható legyen, ha az alapértelmezett mozdulatoktól eltérő vezérléssel szeretné őket kezelni.
- Olvassa el, hogyan fejleszthetők érintéssel vezérelt események az iOS rendszerben.
- Olvassa el, hogyan fejleszthetők egérrel vezérelt események az OS X rendszerben.
A HTML widget megnyitása
Az összetettebb HTML widgetek esetében előfordulhat, hogy az olvasó villogást tapasztal a HTML inicializálása során, amikor megnyitja a widgetet az iBooks alkalmazásban. A villogás elkerüléséhez módosítsa a widgetet úgy, hogy az szabályozza, hogy az iBooks mikor váltson át a Default.png fájl megjelenítéséről a futó HTML widget megjelenítésére.
Három változtatást kell végeznie ennek az opcionális funkciónak a megvalósításához:
- Vegye fel a „true” (igaz) értékre állított „IBNotifiesOnReady” elemet a widget info.plist fájljába, ezzel jelezve az iBooks számára, hogy a HTML widget fogja tájékoztatni arról, hogy mikor kell átváltani a futó HTML widget megjelenítésére:
<key>IBNotifiesOnReady</key><true/>
- Állítsa be a HTML-fájl HEAD szakaszában az Apple JavaScript-függvénytár betöltését:
<script type="text/javascript" src="AppleClasses/AppleWidget.js"> </script>
Megjegyzés: Az AppleWidget.js beépítetten megtalálható az iPad készülékeken, ezért nem kell belefoglalnia a widgetcsomagba. - Állítsa be a widgetet úgy, hogy tájékoztassa az iBooks alkalmazást arról, ha megtörtént a HTML inicializálása, és az iBooks átválthat a Default.png fájl megjelenítéséről a futó HTML widget megjelenítésére a következő függvény meghívásával (a HTML-fájl HEAD szakaszában befoglalt JavaScript-tárból):
widget.notifyContentIsReady()
Fontos: Ha a HTML widget módosításával kívánja kivédeni a villogást, mindenképpen végezze el mindhárom fenti lépést. A funkció csak így működik megfelelően.
Adatküldés külső webszolgáltatásoknak
A HTML widgetek csak akkor tudnak adatot küldeni külső webszolgáltatásoknak, ha a webszolgáltatásokban meg vannak valósítva a megfelelő CORS- (Cross-Origin Resource Sharing) fejlécek.