- Dokumentacja
- Zdarzenia klienta
Zdarzenia klienta
Zdarzenia wywoływane w grze gracza. Podpinasz je przez addEventHandler w skrypcie klienta.
Bronie 1
Czat i konsola 2
Dźwięk (klient) 1
Elementy 5
onZmieniły się dane elementu - przez setElementData na serwerze albo w skrypcie klienta.Client Element Data Change onElement przeszedł do innego wymiaru.Client Element Dimension Change onElement przeszedł do innego wnętrza.Client Element Interior Change onElement pojawił się w pobliżu gracza (gra go wczytała i rysuje).Client Element Stream In onElement oddalił się i gra przestała go rysować.Client Element Stream Out
Gracze 7
onAnimacja innego gracza. Zdarzenie jest zarejestrowane, ale obecny klient nie wysyła jeszcze tych meldunków, więc na razie nie przychodzi.Client Player Anim onGra innego gracza zgłosiła trafienie: tabelaClient Player Hit dataz numerem elementu celu (target), obrażeniami (damage), bronią (w) i częścią ciała (bp).onInny gracz dołączył do serwera.Client Player Join onInny gracz wyszedł z serwera.Client Player Quit onGracz (lokalny albo inny) pojawił się w świecie.Client Player Spawn onGracz (lokalny albo inny) zginął.Client Player Wasted onGracz oddał strzał z broni palnej: Ty albo inny gracz w pobliżu, którego strzały widać w Twojej grze. Przychodzi raz na każdy pocisk, z punktem wylotu i punktem trafienia. Gra zbiera strzały tylko wtedy, gdy któryś skrypt nasłuchuje tego zdarzenia.Client Player Weapon Fire
Interfejs (GUI) 16
onGracz zatwierdził pole edycji GUI klawiszem Enter.Client GUIAccepted onKontrolka GUI straciła fokus.Client GUIBlur onZmienił się tekst w polu edycji albo notatce GUI.Client GUIChanged onGracz kliknął kontrolkę GUI (przycisk, pole, listę).Client GUIClick onGracz zamknął okno GUI krzyżykiem.Client GUIClose onGracz wybrał pozycję z listy rozwijanej GUI.Client GUICombo Box Accepted onGracz kliknął dwukrotnie kontrolkę GUI (np. wiersz listy).Client GUIDouble Click onKontrolka GUI dostała fokus (np. pole edycji, w które klika gracz).Client GUIFocus onGracz wcisnął przycisk myszy nad kontrolką GUI.Client GUIMouse Down onGracz puścił przycisk myszy nad kontrolką GUI.Client GUIMouse Up onGracz przesunął okno GUI.Client GUIMove onPrzesunięto pasek przewijania GUI.Client GUIScroll onGracz zmienił rozmiar okna GUI.Client GUISize onGracz przełączył zakładkę w panelu zakładek GUI.Client GUITab Switched onKursor najechał na kontrolkę GUI. Przydaje się do podświetleń i podpowiedzi.Client Mouse Enter onKursor zjechał z kontrolki GUI.Client Mouse Leave
Obiekty 1
Ogień 1
Pojazdy 2
onPojazd stracił zdrowie w Twojej grze: od zderzenia, strzałów, wybuchu, ognia albo zmiany zdrowia ze skryptu. Dotyczy każdego pojazdu, który Twoja gra zna, także aut innych graczy. Gra sprawdza zdrowie pojazdów 10 razy na sekundę i tylko wtedy, gdy któryś skrypt nasłuchuje tego zdarzenia; kilka szybkich uszkodzeń w tym czasie przychodzi jako jedna strata.Client Vehicle Damage onPojazd wybuchł (Client Vehicle Explode blowVehiclealbo wybuch zgłoszony przez jego właściciela). Przychodzi w tej samej chwili u wszystkich, tuż przedonClientExplosion.
Przeglądarka 27
onStrona wypisała coś w konsoli JavaScript (Client Browser Console Message console.log). Przydaje się do szukania błędów strony.onProces strony padł. Przeglądarka uruchamia go sama ponownie.Client Browser Crashed onPrzeglądarka jest gotowa (proces stron wystartował) i można w niej ładować adres.Client Browser Created onStrona zmieniła kształt kursora (np. łapka nad linkiem).Client Browser Cursor Change onStrona w przeglądarce się wczytała. Dobre miejsce naClient Browser Document Ready executeBrowserJavascript.onPole tekstowe na stronie dostało albo straciło fokus. Przydaje się do włączania klawiatury dla przeglądarki.Client Browser Input Focus Changed onNie udało się wczytać strony.Client Browser Loading Failed onPrzeglądarka zaczyna ładować stronę.Client Browser Loading Start onPrzeglądarka przechodzi pod nowy adres (np. po kliknięciu linku).Client Browser Navigate isBlockedmówi, czy adres jest zablokowany.onStrona próbuje otworzyć nowe okno (popup). Nowe okna nie są otwierane; możesz za to załadować adres w tej samej przeglądarce.Client Browser Popup onStrona chciała wczytać coś z zablokowanego adresu. Powód:Client Browser Resource Blocked 0domena bez zgody gracza,1czarna lista albo sieć lokalna,2niedozwolony protokół albo adres.onStrona chce pokazać podpowiedź (atrybutClient Browser Tooltip title).onGracz zgodził się na nowe domeny dla przeglądarki (poClient Browser Whitelist Change requestBrowserDomains).onKursor się poruszył (tylko gdy jest widoczny; najwyżej raz na klatkę).Client Cursor Move onElement wszedł w znacznik (marker), w tej grze. Działa dla znaczników z serwera i stworzonych u klienta. Sprawdzane są gracze, pojazdy, postacie, obiekty, pickupy i inne znaczniki, co 100 ms. ZnacznikClient Marker Hit checkpointto koło bez limitu wysokości, pozostałe typy to kula o promieniu równym rozmiarowi znacznika.onElement wyszedł ze znacznika (marker), w tej grze. Zachodzi też, gdy element zniknie albo zostanie przeniesiony poza znacznik.Client Marker Leave onOkno gry zostało zminimalizowane albo straciło pierwszy plan (np. Alt+Tab).Client Minimize onNPC dostał obrażenia w Twojej grze (np. od Twojej broni), zanim trafienie pójdzie na serwer.Client Ped Damage cancelEvent()blokuje trafienie: nie idzie na serwer, a zdrowie NPC wraca do wartości z serwera.onCo klatkę, zaraz po przeliczeniu animacji i kości wszystkich postaci, a przedClient Peds Processed onClientPreRender. TugetPedBonePositionigetPedBoneMatrixdają pozycje z bieżącej klatki, więc przyczepiane ręcznie obiekty i efekty nie zostają klatkę w tyle.onWłasna postać dostała obrażenia: trafienie od innego gracza albo z gry (upadek, ogień, wybuch, auto, utonięcie). Zdarzenie informacyjne - o obrażeniach decyduje serwer, więcClient Player Damage cancelEvent()tu niczego nie blokuje; do blokowania służącancelEvent()wonPlayerDamagena serwerze isetPedDamageProof.onGracz wszedł w znacznik (marker), w tej grze. To samo coClient Player Marker Hit onClientMarkerHit, ale źródłem jest gracz, więc obsługę możesz podpiąć dolocalPlayer.onGracz wyszedł ze znacznika (marker), w tej grze. Źródłem jest gracz.Client Player Marker Leave onGracz zaczął mówić przez czat głosowy (dla lokalnego gracza: jego mikrofon zaczął nadawać). Możesz zablokować wypowiedź innego gracza: wtedy ten gracz nie słyszy jej, aż tamten przestanie mówić.Client Player Voice Start onGracz skończył mówić przez czat głosowy.Client Player Voice Stop onOkno gry wróciło na pierwszy plan po minimalizacji albo Alt+Tab.Client Restore onPojazd, którym kieruje ten gracz, w coś uderzył (nagła zmiana prędkości, co najmniej 2,5 m/s w jednej klatce). Teleport iClient Vehicle Collision setElementVelocityze skryptu się nie liczą.onGra wyliczyła od nowa trasę GPS do znacznika (linia na radarze) albo trasa zniknęła. Punkty trasy dajeClient Waypoint Route Update getPlayerWaypointRoute.
Rysowanie (dx) 3
onPrzychodzi co klatkę przedClient Pre Render onClientRender, bez rysowania. Dostaje czas od poprzedniej klatki, więc nadaje się do płynnego ruchu (kamery, animacje).onWywoływane w każdej klatce gry. Tu rysujesz wszystko, co ma być stale na ekranie: HUD, liczniki, napisy.Client Render onZmieniła się rozdzielczość albo rozmiar okna gry. Przelicz wtedy pozycje interfejsu.Client Screen Size Change
Strefy kolizji 4
onElement wszedł do strefy stworzonej u klienta. Obsługę podepnij do tej strefy albo doClient Col Shape Hit root(zdarzenie nie przechodzi przez rodziców).onElement wyszedł ze strefy stworzonej u klienta.Client Col Shape Leave onElement wszedł do strefy kolizji (wersja od strony elementu, u klienta).Client Element Col Shape Hit onElement wyszedł ze strefy kolizji (wersja od strony elementu, u klienta).Client Element Col Shape Leave
Świat 6
onSerwer włączył albo wyłączył mapę pod ESC (Client Map Enabled Change setMapEnabled,setPlayerMapEnabled).onPołączenie z serwerem się zacięło albo wróciło. Gdy przez 2,5 s nie przychodzą żadne dane, gra pokazuje na środku ekranu „NETWORK TROUBLE”, postać staje w miejscu i przychodziClient Player Network Status status=0; gdy dane wrócą, przychodzistatus=1.onZnacznik GPS lokalnego gracza zniknął: zdjęty na mapie, skryptem albo gracz dojechał.Client Waypoint Remove onLokalny gracz ma nowy znacznik GPS gry: z mapy (Client Waypoint Set "map") albo ze skryptu ("script").onŚwiat został odsłonięty po ekranie wczytywania. Od tej chwili gracz widzi grę.Client World Loaded onDźwięk świata od innego gracza. Zdarzenie jest zarejestrowane, ale obecny klient nie wysyła jeszcze tych meldunków, więc na razie nie przychodzi.Client World Sound
Wejście i sterowanie 4
onGracz wpisał znak (litera z uwzględnieniem układu klawiatury i polskich znaków). Do własnych pól tekstowych rysowanych przezClient Character dx.onGracz kliknął myszą przy widocznym kursorze (poza oknami GUI).Client Click onGracz wcisnął albo puścił klawisz. Zdarzenie widzi każdy klawisz, także te, których gra używa.Client Key onGracz wcisnął Ctrl+V w grze, poza oknem GUI i przeglądarki z polem tekstowym. Zasób dostaje tekst schowka tylko wtedy, nie może go czytać w tle.Client Paste
Zasoby 5
onSkończyło się pobieranie pliku zClient File Download Complete downloadFile(plik<file download="false">). Przychodzi zawsze asynchronicznie, także gdy plik był już pobrany.onZasób wystartował w grze gracza (skrypty klienta są wczytane). Podpięte doClient Resource Start resourceRootprzychodzi tylko dla własnego zasobu.onZasób zatrzymuje się w grze gracza.Client Resource Stop onPostęp pobierania plików (start zasobu alboClient Transfer Box Progress Change downloadFile), najwyżej około 10 razy na sekundę. Przydaje się do własnego paska pobierania.onPasek pobierania zasobów pojawia się albo znika. Po pierwszym pobraniu wszystkich zasobów przychodziClient Transfer Box Visibility Change false; kolejne pobrania dajątruena początku ifalsena końcu. Nie oznacza gotowości świata.