Embed Size (px)
Citation preview
2015-‐11-‐01
Riktiga Vykort – Partner App
Teknisk beskrivning
I denna tekniska beskrivning finns instruktioner på filformat och storlek för texter, loggor, bilder och ramar som skall läggas in i ditt partnererbjudande. Har du frågor kontaktar du i första hand PostNord kundservice via e-post, [email protected].
2
Operativsystem iOS
Behörighet
1. Bundle-ID
Din app’s ”Bundle-iD” skall vara registrera hos PostNord. Detta ger din app behörighet att öppna appen Riktiga Vykort och föra över bilden som skall skickas som vykort tillsammans med den information som skall printas på baksidan på vykortet.
Du anger din app’s ”Bundle-iD” i Orderformuläret när du tecknar avtal om tjänsten.
2. Möjlighet att kunna redigera bild eller inte
Informera PostNord om det skall vara möjligt för användaren att kunna redigera bilden i appen Riktiga Vykort eller inte. Med redigering menas att t ex zooma i bilden och lägga till ramar till bilden. Default är att PostNord har spärrat bild för redigering som hämtas från annan app.
Du anger detta i Orderformuläret när du tecknar avtal om tjänsten.
Konfigurera egen app
1. Namngivning av egen app
Ett URL-schema måste finnas definierat i den egna appen för att användaren skall kunna komma tillbaka till appen efter att ett vykort är skickat.
1. Lägg till parametrarna "URL identifier" och "URL Schemes Item" i appens konfigurationsfil (info.plist) för att stödja ett eget url schema.
2. Lägg in parametrar för "URL Schemes Item" enligt information på fliken "PostNords iPhone-appar"
3. Sätt parametern "URL identifier" till samma värde som finns i appens "Bundle identifier"
4. Skicka information om din app's "Bundle identifier" till [email protected]
Så här ser det ut i appen Riktiga Vykort: Mer info finns här: http://bit.ly/xmBbZF
3
2. Att kunna öppna appen Riktiga Vykort
För att anropa Riktiga Vykort från en annan app utan att skicka med en bild ange: posten-rv://?app=App-name (exempelvis posten-rv://?app=Krax)
App-name = Din egen apps ”URL Scheme”
3. Att öppna appen Riktiga Vykort och skicka med en bild
Normalt sett skickar du en länk till din bild med http:// följt av sökvägen till bilden, för att istället skicka bilden till appen Riktiga Vykort så ersätter du http:// med posten-rv:// istället. Efter sökvägen kan du skicka med parametrar som låter dig styra hur bilden ska visas, mer om detta i nästa del.
För att anropa Riktiga Vykort från en annan app och skicka med en bild:
posten-rv://url.to.your/photo.jpg?id= your.bundle.identifier&appName=your_appname&icon=http://url.to.your.app_icon/57x57.jpg&title= Fin utsikt över staden Barcelona&author=Karl Johansson
Innan denna skickas måste länken formateras:
NSString *formattedURL = [unformattedURL stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
För att sedan skicka till appen Riktiga Vykort:
[[UIApplication sharedApplication] openURL:formattedURL];
4. Parametrar som skickas med bilden
id = Ditt bundle id, som t.ex com.mittföretag.minapp, denna måste skickas med för att appen ska kunna läsa in bilden, samt att ditt id måste registreras innan användning.
title = Titel på bilden (Skrivs ut på baksidan om inga andra titlar är definierade (titleSE, titleDK samt titleEN)
titleSE = Svensk titel på bilden (Skrivs ut på baksidan om vykortet är adresserat till Sverige och Norge)
titleDK = Dansk titel (Skrivs ut på baksidan om vykortet är adresserat till Danmark) titleEN = Engelsk titel (Skrivs ut på baksidan om vykortet är adresserat till annat
land) author = Fotografens namn och/eller ägare av bilden. Max 35 tecken. icon = Länk till appens ikon, ikonen skall vara 57x57 stor appName = Appens namn. Max 15 tecken.
4
5. Knapp i egen app
För bilder som skall kunna skickas som vykort skall du lägga in en knapp som heter ”Vykort”. För app med språkstöd engelska, ”Postcard”. Knappen skall öppna en pop-up i din app enligt nedan.
6. Pop-up i egen app
När användaren klickar på ”Vykorts”-knappen skall en pop-up visas. I pop-up:en visas text samt ikonen för Riktiga Vykort.
Ikon – Riktiga Vykort Länken till ikonen som skall visas i pop-up https://posten.estarrebel.com/Archive/images/IconRiktigaVykort.png
OBS. Ikonen ändras över året, så lägg inte länken i en klass som cachar bilden utan ställ in så att appen alltid hämtar aktuell bild. Användaren har rätt version av appen Riktiga Vykort
5
Användaren har fel version av appen Riktiga Vykort
Användaren har inte appen Riktiga Vykort
7. Riktiga Vykort i AppStore
Följande länk https://itunes.apple.com/se/app/riktiga-vykort/id444458799?mt=8
Baksidan på vykortet Utifrån inkomna parametrar så skrivs följande information ut på baksidan av vykortet:
Vykort med mottagaradress till Sverige och Norge
6
Vykort med mottagaradress till Danmark
Vykort med mottagaradress till övriga världen
7
Operativsystem Android
Behörighet
1. Paket namn
Din app’s ”Paket namn” skall vara registrera hos PostNord. Detta ger din app behörighet att öppna appen Riktiga Vykort och föra över bilden som skall skickas som vykort tillsammans med den information som skall printas på baksidan på vykortet.
Du anger din app’s ”Paket namn” i Orderformuläret när du tecknar avtal om tjänsten.
2. Möjlighet att kunna redigera bild eller inte
Informera PostNord om det skall vara möjligt för användaren att kunna redigera bilden i appen Riktiga Vykort eller inte. Med redigering menas att t ex zooma i bilden och lägga till ramar till bilden. Default är att PostNord har spärrat bild för redigering som hämtas från annan app.
Du anger detta i Orderformuläret när du tecknar avtal om tjänsten.
Konfigurera egen app
1. Egen app - Paketnamn
Ett ”Paketnamn” måste finnas definierat i den egna appen för att man skall kunna komma tillbaka till appen efter att ett vykort är skickat. Det är "Paketnamn" som är kopplingen mellan olika appar.
2. Att kunna öppna appen Riktiga Vykort
Om man vill starta Riktiga Vykort från en annan app på Android görs det med följande ett anrop som frågar OS:et om applikationspaketet finns installerad och i så fall att starta den. Så här ser koden ut för anrop till Riktiga Vykort: final String RIKTIGA_VYKORT_PACKAGE_NAME = "se.posten.riktigavykort"; final Context context= getBaseContext(); final PackageManager pm = context.getPackageManager(); Intent appStartIntent = pm.getLaunchIntentForPackage(RIKTIGA_VYKORT_PACKAGE_NAME); if (null != appStartIntent) { context.startActivity(appStartIntent); } else { Toast.makeText(context, "Could not find app: "+ RIKTIGA_VYKORT_PACKAGE_NAME, Toast.LENGTH_SHORT).show(); }
8
3. Att öppna appen Riktiga Vykort och skicka med en bild
Normalt sett skickar du en länk till din bild med http:// följt av sökvägen till bilden, för att istället skicka bilden till appen Riktiga Vykort så ersätter du http:// med posten-rv:// istället. Efter sökvägen kan du skicka med parametrar som låter dig styra hur bilden ska visas, mer om detta i nästa del.
För att anropa Riktiga Vykort från en annan app och skicka med en bild:
posten-rv://url.to.your/photo.jpg?id= your.package.name&appName=your_appname&icon=http://url.to.your.app_icon/57x57.jpg&title= Fin utsikt över staden Barcelona&author=Karl Johansson
Innan denna skickas måste länken formatteras:
String formattedURL = URLEncoder.encode(unformattedURL, "UTF-8");
För att sedan skicka vidare länken till appen Riktiga Vykort:
Intent i = new Intent(Intent.ACTION_VIEW, Uri.parse(formattedURL)); startActivity(i); 4. Parametrar som skickas med bilden
id = Ditt paket namn, denna måste skickas med för att appen ska kunna läsa in bilden, samt att ditt id måste registreras innan användning.
title = Titel på bilden (Skrivs ut på baksidan om inga andra titlar är definierade (titleSE, titleDK samt titleEN)
titleSE = Svensk titel på bilden (Skrivs ut på baksidan om vykortet är adresserat till Sverige och Norge)
titleDK = Dansk titel (Skrivs ut på baksidan om vykortet är adresserat till Danmark) titleEN = Engelsk titel (Skrivs ut på baksidan om vykortet är adresserat till annat land) author = Fotografens namn och/eller ägare av bilden. Max XX tecken. icon = Länk till appens ikon, ikonen skall vara 57x57 stor appName = Appens namn. Max XX tecken.
5. Knapp i egen app
För de bilder som skall kunna skickas som vykort skall du lägga in en knapp som heter ”Vykort”. För app med språkstöd engelska, ”Postcard”. Knappen skall öppna en pop-up i din app enligt nedan.
9
6. Pop-up i egen app
När användaren klickar på ”Vykorts”-knappen skall en pop-up visas. I pop-up:en visas text samt ikonen för Riktiga Vykort.
Ikon – Riktiga Vykort Länken till ikonen som skall visas i pop-up https://posten.estarrebel.com/Archive/images/IconRiktigaVykort.png
OBS. Ikonen ändras över året, så lägg inte länken i en klass som cachar bilden utan ställ in så att appen alltid hämtar aktuell bild. Användaren har rätt version av appen Riktiga Vykort
Användaren har fel version av appen Riktiga Vykort
10
Användaren har inte appen Riktiga Vykort
7. Riktiga Vykort i Google play
Följande länk https://play.google.com/store/apps/details?id=se.posten.riktigavykort
Baksidan på vykortet Utifrån inkomna parametrar så skrivs följande information ut på baksidan av vykortet:
Vykort med mottagaradress till Sverige och Norge
Vykort med mottagaradress till Danmark
Vykort med mottagaradress till övriga världen
