Development Guide

User Manual: Pdf

Open the PDF directly: View PDF PDF.
Page Count: 17

!
!
!
! !
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!"#"$%&'"()*+,-."*/%0*)1"**
2+(-)"0*3""*4,+'"()".*0"4$-)5*
'%6-$"*4&&$-74)-%(*
*
!
Author:!Devon!Wijesinghe!
Date:!17th!January!2018!
*
* *
Igniter!Bee!
AR!application!development!guide!
2!
Table&of&Contents&
2()0%.,7)-%(*8888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888*9!
:%;*)%*,<"*)1"*=&&$-74)-%(>*8888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888*9!
?"71(%$%+-"<*,<".*8888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888*@!
=071-)"7),0"*%/*)1"*4&&$-74)-%(*A4,+'"()-(+*4*9.*%6B"7)C*88888888888888888888888888888888888888888888888888*D!
E2*%/*)1"*4&&$-74)-%(*8888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888*F!
=..-(+*4*(";*-'4+"*)40+")*)%*G,/%0-4*8888888888888888888888888888888888888888888888888888888888888888888888888888888*H!
=..-(+*4*(";*9.*'%."$*888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888*IJ!
!%;($%4.-(+*9.*'%."$*/0%'*?-(K"074.*888888888888888888888888888888888888888888888888888888888888888888888888888888888888*IJ!
L0"4)-(+*4<<")*6,(.$"*888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888*II!
E&$%4.-(+*)%*)1"*M9*6,7K")*888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888*IF!
!
!&
Igniter!Bee!
AR!application!development!guide!
3!
Introduction&
!
Igniter!Bee!is!4*'%()1$5*<,6<70-&)-%(!to!develop!creativity!and!innovativeness!of!child!around!
the!globe.!Every!month,!2!activities!are!delivered!to!the!subscribers’!doorstep.!A!pack!contains!
one!&15<-74$*'4K"0*47)-#-)5!and!one!computer!programming!guide.!
!
When!the!child!does!the!physical!maker!activity,!he!/she!might!find!it!.-//-7,$)*)%*#-<,4$-N"!the!
what!the!end!product!of!the!activity!should!look!like!by!look!only!at!a!2D!image.!2+(-)"0*6""*
=O*4&&$-74)-%(!is!a!possible!solution!to!this.!The!child!will!be!able!to!download!this!mobile!
application!from!the!Android!Play!store!or!Apple!App!store,!and!view!the!model!he/she!has!
the!create! in!a! 3D!manor.!Furthermore,!the!child!could!use!the!app! to!access! the!tutorial!
related!to!a!specific!activity!in!the!app!it!self.!!
!
!
!How&to&use&the&Application?&
!
The!user!will!be!provided!with!an!image!target!along!with!the!
pack!he/she!receives.!To!view!the!3d!model,!the!user!simply!
has!to!%&"(*)1"*=O*74'"04!in!the!app!and!&%-()*4)*)1"*-'4+"*
)40+").!The!image!related!3d!model!will!be!augmented!n!top!
of!the!target!image!
!
After!the!3d!image!is!augmented!on!the!target,!4*6,))%(*;-$$*
4&&"4r!in!the!button!of!the!screen.!This!button!can!be!pressed!
to!#-";*)1"*),)%0-4$!related!to!the!specific!activity!
!
P%)"!Q*?1"* '%6-$"* <1%,$.* 6"* 7%(("7)".* )%* )1"*
-()"0(")*-(*%0."0*)%*%&"(*4(.*,<"* )1"*=O* 74'"048*2/*
(%)*)1"*/%$$%;-(+*&%&*,&*;-$$*6"*<1%;(8!
!
!
Igniter!Bee!
AR!application!development!guide!
4!
Technologies&used&
!
*
*
*
*
E(-)5Q!Used!to!develop!the!mobile!application!(UI!+!Logic!using!C#!scripts).!
!
!
*
*
G,/%0-4*$-60405Q*This!is!used!to!make!a!3D!object!augment!on!top!of!an!image!target!and!for!
cloud!recognition!of!image!targets.!
!
!
*
*
*=RM*M9*3,7K")Q*S3!bucket!is!used!to!store!asset!bundles!(compressed!3D!objects).!And!also!
used!to!store!the!html!tutorials!
!
!
!
!
!
?-(K"074.Q!This!is!used!to!create!3D!models!
!
!
*
*
*
=(.0%-.S*2TM*M!UQ*To!build!the!!project!to!run!on!a!specific!platform8*
&
Igniter!Bee!
AR!application!development!guide!
5!
Architecture&of&the&application&(augmenting&a&3d&object)&
!
!
!&
Igniter!Bee!
AR!application!development!guide!
6!
UI&of&the&application&
!
!
!
!
!
!
!
!&
Igniter!Bee!
AR!application!development!guide!
7!
Adding&a&new&image&target&to&Vuforia&
R14)*-<*("".".Q*
*
1)!A!png!or!jpg/jpeg!image!(Your!target!image)!
2)!A!.txt!file!containing!the!name!of!the!object!A'")4.4)4C8*This!metadata!name!is!really!
-'&%0)4()*(Will!will!look!at!in!the!future!pages!of!this!guide).!
!
!
!
!
*
*
*
?%*4..*-'4+"*)40+")<V*5%,*14#"*)%Q*
*
M)"&*IW*Login!to!your!vuforia!developer!portal.!
X-(K*:!https://developer.vuforia.com/license-managerAdding!a!new!3d!model!!
!
M)"&*YW*Go!to!develop!tab!
!
*
*
&
&
&
&
&
!
Igniter!Bee!
AR!application!development!guide!
8!
M)"&*9W*After!you!login,!go!to!the!)40+")*'4(4+"0!tab!and!select!your!7$%,.*.4)464<"!from!
the!databases!section!and!click!on!it.!
!
!
!
!
!
!
!
!
!
!
!
M)"&*@W*Click!the!=..*?40+")!button!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
Igniter!Bee!
AR!application!development!guide!
9!
M)"&*DW*You!will!get!a!pop!up!window,!select!the!image!target.png/.jpg/.jpeg!and!the!
metadata.txt!file!from!your!local!storage.!You!can!give!any!width!and!any!name!for!the!
image!target.!Then!click!the!add!button(Your!target!image!will!get!uploaded)!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
You!can!view!the!added!targets!,!as!shown!in!the!screenshot!below:!
!
!
!
!
!
!
!
!
! !
Igniter!Bee!
AR!application!development!guide!
10!
Adding&a&new&3d&model&
!
Downloading&3d&model&from&Tinkercad&
!
M)"&*IW*Login!in!to!?-(K"074.!account!and!click!on!the!model!u!made!and!click!download!for!
3D!printing.!
!
X-(KQ*https://www.tinkercad.com/!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
!
M)"&*YW*Download!it!ad!an!8T3Z!file!
!
You!will!get!a!zip!file!in!your!downloads,!unzip!it!to!get!a!folder!like!this!containing!two!files:!
!
!
[R"*;-$$*,<"*)1-<*/%$."0*$4)"0*
%(*-(*)1-<*+,-."*
!&
Igniter!Bee!
AR!application!development!guide!
11!
Creating&asset&bundle&
!
After!you!clone!the!project!from!Github,!there!will!be!a!folder!called!\=<<")*6,(.$"*70"4)%0*
&0%B"7)]*
*
M)"&*IW*Open!that!folder!and!u!will!find!a!unity!project!name!\L0"4)"3,(.$"<]8*Open!it!in!
Unity.!
!
You!should!see!a!screen!like!this:!
!
M)"&*YW*On!the!bottom!left,!you!will!see!a!file!structure,!with!Assets!as!the!root!folder!(refer!
the!screen!shot!above).!Click!on!the!‘^0"/46<_!folder!
!
M)"&*9W*If!there!are!any!folders!inside!the!prefabs!folder,!right!click!and!."$")"!them!4$$*
*
M)"&*@W*Drag%and%drop!the!folder!you!got!from!?-(K"074.*V*inside!the*^0"/46<*folder.!
!
!
!
!
!
!
!
!
!
! !
Igniter!Bee!
AR!application!development!guide!
12!
M)"&*D-!Rename!the!.obj!file!to!the!`a=L?!name!you!gave!in!the!image!target!metadata!A*)1"*
(4'"*-(*)1"*8)b)*/-$"*;1-71*;4<*,&$%4.".*)%*G,/%0-4*4$%(+*;-)1*)1"*)40+")*-'4+"C*
*
!
!
!
!
!
!
!
!
!
!
!
M)"&*F-!Click!on!the!.obj!file!and!a!&4("$*<1%;-(+*)1"*%6B"7)!will!appear!on!the!6%))%'*
0-+1),!as!show!below:!
*
! !
Igniter!Bee!
AR!application!development!guide!
13!
M)"&*H-!On!the!bottom!of!the!panel!shown!above!,!there!will!be!a!label!called!‘=<<")3,(.$"_.!
And!there!will!be!two!drop!drops!next!to!it.!!
Click!on!the!/-0<)!drop!down,!and!select!‘(";_*and*type*c'%."$_*%0*-/*-)*-<*4$0"4.5*4#4-$46$"V*
B,<)*<"$"7)*c'%."$_*
*
*
*
*
*
*
*
*
*
M)"&*d-!Then!click!on!the!<"7%(.!drop!down!and!click!new!and!type!the!`a=L?!(4'"!of!the!
object!(.obj!that!u!renamed)!
!
!
!
! !
Igniter!Bee!
AR!application!development!guide!
14!
M)"&*e-!After!that!is!done,!click!on!the!c=<<")<_!on!the!top!tool!bar!and!select!the!option!at!
last!which!says!cL0"4)"*)1"*=<<")3,(.$"<_*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
M)"&*IJ-!Then!you!have!right!click!the!‘=<<")3,(.$"_!folder!on!the!6%))%'*$"/)!file!structure!
and!click!cO"#"4$*-(*/-(."0_!
*
*
*
*
*
! !
Igniter!Bee!
AR!application!development!guide!
15!
You!will!get!four!files!(or%more%if%there%a%files%in%the%folder%already)!like!show!below.!
!
!
!
!
!
!
!
!
M)"&*II-!Select!the!file!which!has!the!name!'%."$8(4'"T/?1"T6B"7)!TPXf8*
*
The!%)1"0*/-$"<!will!(%)!be!used.!The!selected!file!can!be!copied!to!a!accessible!location!in!
the!local!storage!(eg!:desktop)!,!because!it!needs!to!be!,&$%4.".!to!a!AWS!M9*6,7K")*
*
&
!&
Igniter!Bee!
AR!application!development!guide!
16!
Uploading&to&the&S3&bucket&
!
M)"&*I-!Login!to!AWS!console!and!go!to!the!s3!buckets!section!
!
M)"&*Y-!Select!the!c40W4&&W%6B"7)<_*bucket!from!the!list!
!
M)"&*9-!Click!the!upload!button!and!upload!the!single!file!(asset!bundle)!you!selected!(saved!
to!the!desktop)!in!the!previous!part!of!this!guide.!g4K"*<,0"*5%,*'4K"*)1"*/-$"*^E3X2L*)%*
"#"05%("8*
*
You!can!view!all!the!uploaded!asset!bundle!now:!
That’s it : )
*
Igniter!Bee!
AR!application!development!guide!
17!
*
h%0*4(5*-(i,-0-"<*W*
!
`'4-$:!wdevon99@gmail.com!!
h47"6%%K:!https://www.facebook.com/wdevon99!
g%6-$":!0779141958!
!
!

Navigation menu