2.2. Mäng 2: 2D platformer

3.1 Horisontaalse liikumise programmeerimine

Update() funktsiooni nurgelistesse sulgudesse panna ujukomaarv inputX väärtuseks klaviatuuri "horisontaaltelje" (vaikimisi klahvid "A" ja "D", vasak ja parem nool) sisend:

inputX = Input.GetAxis("Horizontal");

Analoogselt teha seda ka inputY-iga (tuleb kasutusele hiljem):

inputY = Input.GetAxis("Vertical");

Input.GetAxis on funktsioon, mis annab klaviatuurisisenditelje väärtuse ajaliselt interpoleerituna – see tähendab, et kui kasutaja vajutab näiteks klahvi "D", väljastab see funktsioon Input Manageris defineeritud ajalises vahemikus ujukomaarvu väärtused 0f...1f näiteks 0.5 sekundi jooksul ning kui kasutaja vajutab klahvi "A" siis see funktsioon teeb sama, aga vastasmärgiliselt. 

Input.GetAxisRaw on alternatiiv, mis ajaliselt ei interpoleeri, seega kohe kui kasutaja vajutab klahvi, on selle funktsiooni väljund 1 või -1.

Need mõlemad funktsioonid väljastavad 0-i kui mõlemat telje klahvi hoitakse korraga peal.

Edit --> Project Settings --> Input alt saab leida Input Manageri, kus saab muuta ja seadistada klaviatuuri sisendi telgesid, seal on vaikimisi olemas teljed "Horizontal" ja "Vertical".

Skripti lisada juurde lisaks Update funktsioonile void FixedUpdate meetod ja selle nurgeliste sulgude sisse objekti rigidbody x-suunalist kiirust modifitseeriv rida:

rb.velocity = new Vector2(inputX * speed, rb.velocity.y);

Nüüd peaks liikumine platvormil vasakule ja paremale töötama. Ära unusta inspektoris skripti aknas seada väärtused muutujatele nimega speed ja hiljem jumpSpeed. Kui mängija kapsel kukub külili, tuleb mängija RigidBody2D komponendis inspektormenüüs Constraints --> Rotation --> Z seadma vääraks. Kui kaamera vaateväljast liigub kiirest eemale, võib esialgu hierarhias aheldada kaamera mängija külge. 

3.2 Hüppamise programmeerimine

Kuna see hüppamiseks vajalik y-sihilise kiiruse muutus saab toimuda ühe kaadri vältel, võib hüppamist programmeerida Update funktsioonis.  Hüppamine olgu, nagu tavaliselt, klahviga "Space", millele saab argumendis viidata KeyCode.Space-iga või InputManageris defineerida string "Jump" ning seada selle klahviks "Space". Input.GetKeyDown väljastab tõese boolean väärtuse selle kaadri jooksul, mil seda klahvi vajutatakse. Selle alternatiiv Input.GetKey väljastab kõikide kaadrite jooksul, mil seda nuppu on vajutatud. Hüppamise jaoks on vaja esimest ning on vaja, et onGround ("onMaaPeal" muutuja oleks tõene):

Selleks, et kontrollida mängija kokkupuudet maapinnaga on kaks moodust: 1) kasutada OnCollisionEnter2D (OnCollisionEnter2D is called when this collider2D/rigidbody2D has begun touching another rigidbody2D/collider2D.) funktsiooni 2) kasutada FixedUpdate funktsioonis Physics2D.CircleCasti või Physics2D.RayCasti funktsiooni, mis iga kaadri kestel tekitab kujuteldava kiire või rõnga, mis kontrollib, kas see kiir või rõngas lõikub mõne collideriga. 

1) OnCollisionEnter2D on kõige lihtsam üles seada, kuid on ebatäpne. Näiteks kui "Ground" tagiga objekt on mängija vastas (külje pealt kui mängija on vastu seina), on onGround muutuja tõene ning saab hüpata, kuigi see ei pruugi olla arendaja kavatsus. Kuna OnCollisionEnter töötab ainult siis, kui mingi colliderite-vaheline kokkupõrge on toimumas, siis if-else lause OnCollisionEnteriga ei töötaks. Tuleb lisaks kasutada OnCollisionExit funktsiooni, mis töötab analoogselt, aga siis, kui koos olevad kokku põrkanud colliderid lahknevad:

4.2 Redelil liikumise ning redelil olemise piirangute programmeerimine

Redelil peaks olema võimalik liikuda nii x- kui ka y-suunas ning redelil ei tohiks olla võimalik hüpata (kui just mitte redelilt maha hüpata) ega redelil ei peaks simuleerima Rigidbody2D gravitatsioonikiirendus (rb.isDynamic = false).

Selleks tuleb panna Update funktsioonis hüppamine ning FixedUpdate funktsioonis horisontaalne liikumine if-lause loogeliste sulgude sisse ning selle if-lause argumendiks peab olema redelil olemist kontrolliv boolean: 

if(onLadder == false) { // horisontaalset liikumist või hüppamist teostav kood (NB! mitte sisend) }

Kui tavapärane liikumine on redelil olekust tingitult "lukus", tuleb redelil liikumine eraldi ridadega tekitada. Kõik uued redelil liikumisega seotud read tuleb panna if-lausesesse, mille argumendi tingimuseks on redelil oleku tõesus (onLadder == true, if-lause argumendis lihtsalt: if(onLadder) või if(onLadder){ ... } else { ... }). Kui on soov kasutada mingit muud kiirust redelil liikumiseks, võib järgnevas koodis korrutada tavakiiruse mingi koefitsiendiga (0.5f * speed) või tekitada algusesse uus "avalik" float muutuja (public float onLadderSpeed;). Järgnev kood kasutab esimest viisi. Järgnev koodlilõik on osa FixedUpdate event funktsioonist ning arvestab ka vastase juhuga (!onLadder ehk mitte redelil):

Rigidbody2D.gravityScale, mis eelnevas näites, on üks paljudest viisidest gravitatsiooni skaleerimise jaoks (vaikimisi on selle väärtus 1). Teised viisid on Rigidbody2D.isKinematic ja Rigidbody2D.isDynamic booleanide muutmine.

On hea viis kuidas praeguseni valminud skripti optimeerida: rb.gravityScale saab antud juhul FixedUpdate-is seatud põhimõtteliselt iga kaadri (fikseeritud füüsikakaadri) vältel väärtuse. Samas seda pole vaja iga kaader teha. Piisab rb.gravityScale väärtuse vahetamisest nende kaadrite kestel, mil void OnTrigger... event functionid, mis praeguses skriptis redelil olekut kontrollivad, töötavad.  Järgnev koodilõik on viimast osa kokkuvõttev: