Allgemein

go~mus unterstützt digitale Tickets für das Apple Wallet (“Passbook”) als zusätzliche Funktion neben print@home-Tickets (PDF). Siehe hierzu auch das Apple Developer Guide für Passbooks.

go~mus unterstützt für den Typ “eventTicket” zwei Varianten: 

1. Hintergrund-Ticket (Background)
2. Querbild-Ticket (Strip)

Die Media-Dateien und Angaben auf dem Ticket müssen entsprechend der Variante zur Verfügung stehen: 

Bild: Apple Developer Guide, Copyright Apple, https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/PassKit_PG/Art/event_ticket_2x.png

Es werden bis zu 10 Dateien (PNG-Bilddateien) benötigt. Felder und Texte werden von go~mus entsprechend der Ticketkonfiguration automatisch eingefügt.

Hinweis: für das Strip-Ticket werden bitte background.png, background@2x.png sowie thumbnail.png und thumbnail@2x.png nicht benötigt, stattdessen die Dateien für strip.png und strip@2x.png.

Auszug aus dem Apple Developer Guide:

Alle Dateien werden in doppelter Auflösung zusätzlich benötigt (“@2x”). Wenn Dateien fehlen, kann das Ticket nicht verwendet werden.

Bilder: Formate, Positionen und Größen

Folgende ergänzenden Informationen finden sich in dem Apple Developer Guide: 

Images Fill Their Allotted Space

The pass layout allots a certain area on the front of the pass for each image. Images are scaled (preserving aspect ratio) to fill this allotted space. Images with a different aspect ratio than their allotted space are cropped after being scaled. The space allotted is as follows:

• The background image (background.png) is displayed behind the entire front of the pass. The expected dimensions are 180 x 220 points. The image is cropped slightly on all sides and blurred. Depending on the image, you can often provide an image at a smaller size and let it be scaled up, because the blur effect hides details. This lets you reduce the file size without a noticeable difference in the pass.
• The footer image (footer.png) is displayed near the barcode. The allotted space is 286 x 15 points.
• The icon (icon.png) is displayed when a pass is shown on the lock screen and by apps such as Mail when showing a pass attached to an email. The icon should measure 29 x 29 points.
• The logo image (logo.png) is displayed in the top left corner of the pass, next to the logo text. The allotted space is 160 x 50 points; in most cases it should be narrower.
• The strip image (strip.png) is displayed behind the primary fields.
• On iPhone 6 and 6 Plus The allotted space is 375 x 98 points for event tickets, 375 x 144 points for gift cards and coupons, and 375 x 123 in all other cases.
• On prior hardware The allotted space is 320 x 84 points for event tickets, 320 x 110 points for other pass styles with a square barcode on devices with 3.5 inch screens, and 320 x 123 in all other cases.
• The thumbnail image (thumbnail.png) displayed next to the fields on the front of the pass. The allotted space is 90 x 90 points. The aspect ratio should be in the range of 2:3 to 3:2, otherwise the image is cropped.

The dimensions given above are all in points. On a non-Retina display, each point equals exactly 1 pixel. On a Retina display, there are 2 or 3 pixels per point, depending on the device. To support all screen sizes and resolutions, provide the original, @2x, and @3x versions of your art.

Quelle: https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html

Tipp: Wenn einzelne Bilder nicht angezeigt werden sollen, das Hoichladen von Bildern aber von der Software gefordert wird, können transparente Bilder hochgeladen werden.

Custom Felder

Um in den Sektionen

• Additional secondary fields
• Additional auxillary fields
• Additional back fields (Felder auf der Rückseite des Tickets)

eigene Einträge zu definieren, müssen diese nach folgendem Schema angelegt werden: 

[{
"key": "…",
"label": "…",
"value": "…"
}]

Dabei ist key ein interner Name, der nicht dargestellt wird, label ist der Text, der als Titel verwendet wird, und value gibt den Text an, der als Inhalt oder Beschreibung auf das Ticket gedruckt wird. Hier ist ein Beispiel:

[{
"key": "opening-hours",
"label": "Öffnungszeiten",
"value": "10 bis 18 UHR"
}]

Wenn mehrere Einträge in einer Sektion eingerichtet werden sollen, müssen die Einträge nach folgendem Schema angelegt werden:

[{
"key": "…",
"label": "…",
"value": "…"
},
{
"key": "…",
"label": "…",
"value": "…"
}]

Zeilenumbrüche können über die Zeichenkombination \n eingefügt werden. Dabei müssen keine Leerzeichen vor oder nach der Zeichenkombination verwendet werden. Der Umbruch im folgenden screenshot kommt ist beispielsweise folgendermaßen realisiert.

[{
"key": "opening-hours",
"label": "Öffnungszeiten",
"value": "Dienstag – Freitag 9:30 – 18:00 Uhr\nSamstag / Sonntag / Feiertag 10:00 – 18:00 Uhr“
}]