Co

onte
ent SSpeccificaation
ns
In
nteracctiveC
Conteent



ADFLLOW Ne
etworkss Interactivee Content
Possibllescreen sizes
Orientatio
on Aspectt Ratio Reso
olution
Landscapee 16:9 1280
0720,13607
768,1600900,,19201080
4:3 640
480,800600
0,1024768,122801024
Portrait 9:16 720
1280,76813
360,9001600,,10801920
3:4 480
640,600800
0,7681024,100241280

Itisrecom
mmendedthaatallcontentbecreatedto
omatchtherresolutionbeiingoutputted
dbythescreeento
avoiddisttortionorscaling.

on1.4Oct920144
Versio


Whatt is a KM
MAP?
KMAPstandsforKioskkMapanddeffineswhatfile esarelinked togetherinaaninteractiveeexperience.Each
linkorbutttoninanexp
periencewillreferenceau uniquekeyanndeachkeyw willhaveaSWWFassociatedwith
itinsideth
heKMAP.

Dependin ngonhowyou urexperience eiscreated,aaKMAPwillh aveasmanyorasfewkeyysasnecessary.If

youcreateaninteractiiveexperiencceinasingleSSWFthenyouurKMAPwillonlyconsisto ofasinglekeyy
calledtheeHOMEkey.IfyourexperrienceisbrokenupintomuultipleSWFfiiles,yourland dingpage(thefirst
pagethatisdisplayedwwhenauserttouchesthesscreen)willreesideintheH HOMEkeyand dfromtheremany
otherkeyswillbeused dtolinkeachpagetogethe er.

AKMAPaalsohastheabilitytohaveaBarkerorA AttractLoopaassociatedwiithit.Thisisalsoscheduleed
throughtheDMSandcconsistsofassingle(ormultiple)FlashoorVideofilesthatdirectyo ouruserstottouch
thescreen ntobeginthe
eexperience..

Creatting an experie
ence
Interactivveexperiencesarecreated
dinFlashandthesefilesruunontheADFFLOWmediaplayersoftwaare.
Thereareetwowaystocreateanintteractiveexpe
erienceinFlaash:

As
A a single SW WF:allfilesoftheexperiencearesttoredinsideasingleFlasshfilewhich
his
sttoredinsideaKMAP.
Pros:
Asinglefileiseasiertomaanage.
On nlyonesingllefileneedstobeschedduledintheDMS.
Cons:
Th hiscanleadttolargefilessizesthatcaancauseissu
ueswithslow
wernetworkks.
Evverytimeassinglepageo oftheexperiienceneedstobeupdattedtheentirre
exxperiencewiillneedtobe ereuploadeedandreplaacedintheD DMS

Divided
D into multiple SW WFs: eachpageoftheeexperienceissitsownfileeandtheseffiles
arelinkedtoggetherinthe eDMSusingKMAPs.
Pros:
On nlythepage esoftheexperiencewithhupdatesw willneedtob
bereplacedwwhen
therearechan nges
Sm mallerfilesizzesleadtofaasterdownlooadsandlesssbandwidthusage
Cons:
Multiplefilescanbemore edifficulttokeeptracko
oformanagge

on1.4Oct920144
Versio


Speciification
ns
FLASH (.swf)
VERSION:: 8or9
FRAME RA ATE: 1230fps
OPTIMALL FILE SIZE: 10MBorle
ess
FILE SIZE LIMIT: 100MB
PUBLISH SETTINGS:
S

Lo
oad Order: BottomUp

Options:
O Generatesizereport
OmitTraceaction
Protectfromimport
DebuggingPermittedunnchecked
JPEGQualitty:100%

Ensure all assets are in

ncluded within your flash file, no exterrnal assets (ssuch as videos or images)
should evver be referennced.

Develo
opinganeexperiencceinmulttipleSWFFs
onofSWFfilees(oneforeachpageofttheexperiencce)
Ifyouwillbecreatingyyourcontentasacollectio
thenthissectionwillexplainhowthhisworkswith htheKMAPs intheDMS.

EachSWFForpageofyo ourexperienccewillbe
droppediintoapartofaKMAPwhicchconnects
theentire
eexperiencettogether.The eeasiest
waytodeevelopconten ntforKMAPsistolayout
allthemaainpagesina blockdiagram.Each
nodeinthhisdiagramwwillbeapagewithinthe
experiencceandwillhaveauniquekkeythatcan
becalledfromanyotherfilewithinthe
schedule.

Totellthe
emediaplayeertoloadafillewithin
thesched dule,forexam
mpleMainMen nu.swfwhich
hhasauniqueekeyofMAIN Actionscriptonthe
NMENUtheA
associated dbuttonorhotspotwilllo
ooksomethingglikethis:

fscommand( PLAY_
_NOW, BTN_PHONES,P
PHONESOVERV
VIEW );

Whentheebuttonorho otspotistoucched,themed diaplayerwil llookforakeeynamedPH

HONESOVERVIIEW
andloadttheassociatedfile.ThefirsstparametercalledBTN_PPHONESisusedprimarilyfforlogging,w
when

on1.4Oct920144
Versio


thePLAY_
_NOWcommandiscalled;itlogswhatbuttonwasppushedandw
whatkeywasloaded,inthiis
caseBTN_
_PHONESand
dPHONESOVEERVIEW.

Develo
opinganeexperiencceasasin
ngleSWFF
WFyouwillsttilldropyourfileintoaKM
IfyouwillbecreatingyyourcontentasasingleSW MAPhoweverryou
willnotne KMAPsousinggkeysintheaactionsofyourbuttonsisnot
eedtolinkpaagestogetherrwithintheK
necessaryy.Yourfilewillresideinth
heKMAPasthhehomekeyyandwillbetheonlyfilewwithintheKM
MAP.

Youwillalsonotbeasssigningkeysttoeachpageinordertolinnkthemtogeether;youwillbedoingthiis
fromwith ead.Youwillonlybeusinggfscommandssforloggingp
hinflashinste purposeswhichwillbe
explaineddintheloggin
ngsectionoftthisdocumen nt.

Loggiing with
h the ADFLOW
A W Mediaa Playeer
Overvi ew
ThemediaaplayerLOGcommandisusedbytherreportingengginetogeneraateusagerep portsdisplaying
kioskactivvity.Forspecificeventstobelogged(e.g.buttonpreesses,navigation,gamereesults)an
fscommand (LOG) )mustbeissu ued.

KeyNa
ames
Keyname
esshouldbed
descriptivebu
utmustalsocconformtoceertainspecificcations:
Thheymustbeuppercase
Useunderscorresinsteadoffspaces
Usealphanumericcharacte ersonly(nosq
quarebrackettsorsymbolss)

Howto
oLogFor Reports
Inordertobeginlogginngeventsyou umustfirstinnsertfscomm mandsintotheeActionscriptttowriteeveents
intothemmediaplayersslogfile.Wh
henloggingd dataitisimpoortantthatcleearandmean ningfultagsarre
used.Ifyyouaregoingtobesimplyloggingpagenavigationinnformationth henusingnammeslike
PHONE_P PAGEandHOME_PAGEare esufficient.Iffyouneedtoologseveralttypesofeven
ntslikebutton
n
pushes,navigation,etcc.thenprefixingtheloggedinformationnwiththeacttionispreferable.Forexaample
abuttonp pushcouldbe
eloggedas:B BUTTON PHO ONE_BTN.

Actionsscriptexa
amples
Tosendacommandto othemediap
playertheActtionscriptcom
mmand
fscommand(command d,arguments)isused.To odirectthem
mediaplayerttologanarbiitrarymessaggeto
thelogfilesthefollowingcommand disused:

fscommand( LOG,
, <Message to log>
);

on1.4Oct920144
Versio


TologB
BUTTON PHON
NE_BTNtotthelogfilesisssuethefollow
wingcommand:

fscommand( LOG,
, BUTTON PHONE_BTN );

Thiswillin
nsertBUTTO HONE_BTNintothemedi aplayersloggfilewhichcaanbeusedfo
ONDOWN:PH or
testingorrreportingpu
urposes.

InActionsscript3toutilizethefsco
ommandfunctionitisimpe rativethatyo
ouimporttheefollowing:

import flash.syst
tem.fscommand;

Usingg Shared Objects

Overvi ew
Flashssharedobjectscanbeusedttopassvariabblesandotheerdatastructu uresbetween
nSWFs.Thisddata
canbeusedtomaintainstateandsshareinformaationbetwee npageswithiintheADFLOWexperiencee.
Theexammpleincludedinthisdocum mentwillshowwhowtokeeepaspecificp pageopen(inthisexampleethe
roamingppage)evenaffteraspecificeventhasocccurred(atet herislifted).

Howit works
Whenapageisloaded dintothemed diaplayer,forexampletheeroamingpaage,asharedobjectiscreaated
andavariiableissetwiithinthispage
e.Whenatettherislifted, thepagefortheassociateedtether,thissis
thephone edevicepage eassociatedw herinthiscas ephone0,isloadedandd
withthatteth displayed.Thiis
newlyloadedpagewillfirstcheckto oseeifthepreviouspage (roaming)haadsetavariableintheshaared
objectind
dicatingthattthepreviousp pageshouldn notbenavigaatedfrombyliftingthetetther.Ifso
Actionscriiptisusedtosendanfscommandtoth hemediaplayyer.UsingtheePLAY_NOW Wcommandth he
pagewillnavigatetoaspecialkeyccalled[BACK] whichwilllooadtheprevio ouspage,thisspagecheckssfora
variablesetbythetethherpage(pho one0)indicattingthatnaviggationhappeenedbecauseofthetetherrand
navigatinggfromtheroamingpagesshouldntoccurbecauseo fthetether.Ifthisvariableissetthenaclip
withabutttonthatwillallownavigationtotheph hone0pageaappears.Thephone0pageealsoseta
variablethatcontainstthekeythattthemediaplaayerwillneeddtonavigateback.Uponp pushingthe
unhiddenbuttonthekkeyisreadfro omtheshared dobjectandaaPLAY_NOW Wcommandississuedtothe
mediaplaayer.

Actionsscriptexa
amples
Otherthaantheuseofssharedobjecttsthemaintaakeawayfrommthissectionnishowtoteellthemedia
ommandtothhemediaplayyertheActionscriptcomm
playertonavigatetoaspecifickey.Tosendaco mand
fscommand( comman nd, arguments ) isuse ed.Todirecttthemediaplaayertonavigaatetoanewkey
usethefo
ollowing:

fscommand( PLAY_
_NOW, <Message to log>,<Lib rary Key>
);

on1.4Oct920144
Versio


SotoplayythePHONESSkeyandlogBTN_PHONEStothelogtthefollowingcommandwiillbeused:

fscommand( PLAY_
_NOW, BTN_PHONES,P
PHONES );

TheBTN__PHONESlogggingcanbeussedlatertoddeterminehow wapersonnavigatedtoaspecificpagee,this
ishandyw
whenitcomestimetogenneratereportssonbuttonppressesespecciallyifthereaaremultiple
buttonso
ononepagethatallgototthesameplacce.

ommandfunctionitisimpe rativethatyo
InActionsscript3toutilizethefsco ouimporttheefollowing:

import flash.syst
tem.fscommand;

UsingSSharedO bjects

on1.4Oct920144
Versio


Preve
enting Timeou
T uts
Overvi ew
Thesectioonwilldescribbehowtopreeventtheexp
periencefrommtimingoutaandreloadinggtheattractloop.
Thiswillo
occurafterassetamountoftimeaftern
nointeractionnsoccuronth
hescreen.Th
hismethodishow
toenablelockingthesscreen.Topro dtoincludeportionsofthee
ovidelockoutforatetheryyouwillneed
sharedob bjectcodewitththislockou
utmethodology.

Howit works
Themediaaplayerundeerstandslimittedcommand
dsyntax.Thessecommandssarepassedttothemedia
playerusingtheAction
nscriptcommmandfscommaand( comma and, arguments ).Inth hesharedobjject
sectionwelearnedabooutthePLAY_ _NOWcommmandandtouusetheresetfunctionalitythesyntaxisas
follows:

fscommand( TIMEO
OUT_RESET, <passed
d to log> );

InActionsscript3toutilizethefsco
ommandfunctionitisimpe rativethatyo
ouimporttheefollowing:

tem.fscommand;
import flash.syst

on1.4Oct920144
Versio


Best Practices
Allconten
ntmustbetesstedonequippment(mediaaplayerandsscreen)thatw
willbeusedin nthefieldto
ensuredeesiredplaybacckisachieved
d.Contentsh
houldbetesteedthroughouuttheentired developmentt
processoftheexperiencetoensure behavesasexxpected.Thissisacriticalssteptoavoidany
eeverythingb
delaysorproblemsintthedeployme entofyourco
ontent.

Ensuree:
Allhotspotsmustbelargee enoughtoacccommodateaatouchonth hescreen.Keeepinmindth
hat
to
ouchingisnottaspreciseaspointingandclickingwitthamouse.H
Hotspotsshou uldalsohave
ad
dequatespaccearoundthe emsomultipleorincorrectthotspotsareenotbeingtrriggered.

Avoid:
Creatinganexperiencewhe ereeveryfileisverylarge (30MB+)tohhelpkeepdownloadtimessand
bandwidthusaagetoaminim mum
Im
mplementinghoverstates.Thereisnowaytohoverronatouchsscreenanditcancause
unexpectedan ndundesirableresults.
Usingtinyfontts(eveninleggalparagraphhs).Allconte ntshouldbetestedontheescreenthatwill
bedisplayingtthecontentinnthefieldtoensurealltexxtisreadablee.
Loowcontrastccoloursforfontsandbackggrounds.Enssureyourfonttsaresignificcantlydarkeror
ligghterthanthebackground dtheywillappearontoennsureeaseofflegibility

Sound
Ifyourcontenthassouunditisimpo urethatthesooundisataggoodvolumelevelforthe
ortanttoensu
oensurethatthevolumelevel
environmentinwhichyourscreen(ss)willbeplacced.Itisalsoimportantto
isconsiste
entacrossthe
eentireexperience.

Testingon
ntheactualsscreen/speakeersbeingusedshouldbetthefirststeptoensuringaappropriate
volumeleevelsaremainntained.Dependingonthetypesoffixtturesyouareeusingyoum
mayneedtoviisit
theactuallocationwherethescreeen(s)is/arebe
einginstalled topreviewth
hesoundinittsnative
environmentandmake eadjustmenttsbasedonth
hisaswellas user/employyeefeedback.

You, yourr agency or ADFLOW mustt be testing and

a previewin
ng content prrior to deployyment.

on1.4Oct920144
Versio


Contaacts
Ifyourequireanyconttentrelatedaassistanceple
easecontactyyourcontentlead,projectmanageroruse
thedetailsprovidedbeelow.

content@
@adflownetwo
orks.com

DMSrelattedquestionssincludingsch
hedulingofco
ontentcanalssobedirecteddto:

Catherinee Brady
Directoro
ofClientServices
cbrady@
@adflownetw
works.com
(905)3330200x226

on1.4Oct920144
Versio