- Dokumentacja
- Przeglądarka
Kategoria
Przeglądarka
Wszystkie funkcje i zdarzenia Lua z kategorii Przeglądarka, po stronie serwera i klienta.
Funkcje klienta 45
canSprawdza, czy w historii przeglądarki jest poprzednia strona.Browser Navigate Back canSprawdza, czy w historii przeglądarki jest następna strona.Browser Navigate Forward createTworzy przeglądarkę, czyli stronę HTML renderowaną do tekstury. Rysujesz ją przezBrowser dxDrawImage, a adres ładujesz dopiero w zdarzeniuonClientBrowserCreated.evaluateWykonuje kod JavaScript na stronie lokalnej i oddaje jego wynik do Lua. Jeśli kod zwraca Promise, funkcja czeka na wynik.Browser Javascript executeWykonuje kod JavaScript na stronie. Działa tylko na przeglądarkach lokalnych.Browser Javascript focusPrzekazuje klawiaturę przeglądarce. Tekst trafia do strony, gdy jej pole tekstowe jest aktywne i widać kursor.Browser nilzdejmuje skupienie z wszystkich przeglądarek.getZwraca, ile razy na sekundę strona jest przerysowywana.Browser Frame Rate getZwraca krycie piksela strony. Przydaje się, żeby kliknięcia w przezroczyste miejsca HUD-u trafiały do gry.Browser Pixel Alpha getZwraca właściwość przeglądarki. Obsługiwana jestBrowser Property "mobile"(widok telefonu).getZwraca wszystkie przeglądarki utworzone przez skrypty.Browsers getZwraca ustawienia przeglądarki wybrane przez gracza (ESC, Ustawienia, Przeglądarka).Browser Settings getZwraca rozmiar przeglądarki w pikselach.Browser Size getPobiera kod HTML bieżącej strony i przekazuje go do funkcji.Browser Source getZwraca tytuł strony (zBrowser Title <title>).getZwraca bieżący adres strony.Browser URL getZwraca głośność jednej przeglądarki albo, bez argumentu, głośność wszystkich przeglądarek.Browser Volume getZwraca powiększenie strony (Browser Zoom 1to 100%).injectWpisuje tekst w aktywne pole strony, znak po znaku (zdarzeniaBrowser Character keypress/input), także polskie litery i inne znaki UTF-8.injectWysyła do strony naciśnięcie albo puszczenie klawisza (np. Enter, Backspace, strzałki), tak jakby gracz nacisnął go na klawiaturze. Strona dostaje zwykłe zdarzeniaBrowser Key keydown/keyup. Do wpisywania tekstu służyinjectBrowserCharacter.injectWciska przycisk myszy na stronie w miejscu ostatniegoBrowser Mouse Down injectBrowserMouseMove. Dwa wciśnięcia w tym samym miejscu w ciągu 0,5 s strona dostaje jako podwójne kliknięcie, trzy jako potrójne (zaznaczenie akapitu), tak jak w Windows.injectPrzesuwa kursor myszy na stronie.Browser Mouse Move injectPuszcza przycisk myszy na stronie.Browser Mouse Up injectPrzewija stronę kółkiem myszy. Wartości ujemne przewijają w dół i w prawo.Browser Mouse Wheel isSprawdza, czy domena (albo adres) jest niedostępna dla przeglądarek z internetem: przez czarną listę, brak zgody gracza albo wyłączone strony zdalne.Browser Domain Blocked isSprawdza, czy przeglądarka ma skupienie klawiatury.Browser Focused isSprawdza, czy strony rysuje karta graficzna.Browser GPUEnabled isSprawdza, czy strona się jeszcze ładuje.Browser Loading isSprawdza, czy przeglądarka jest lokalna (pliki zasobów), a nie zdalna (internet).Browser Local isSprawdza, czy rysowanie strony jest wstrzymane.Browser Rendering Paused isSprawdza, czy gra może tworzyć przeglądarki.Browser Supported loadŁaduje adres w przeglądarce. Przeglądarka lokalna otwiera pliki zasobów, a zdalna strony z dozwolonych domen.Browser URL navigatePrzechodzi do poprzedniej strony z historii.Browser Back navigatePrzechodzi do następnej strony z historii.Browser Forward reloadPrzeładowuje bieżącą stronę.Browser Page requestProsi gracza o zgodę na strony z podanych domen. Domena musi być na liście serwera (Browser Domains browser_domainswserver-config.json), inne są odrzucane bez pytania. Zgoda jest zapamiętywana.resizeZmienia rozmiar przeglądarki.Browser setOdpowiada z Lua na zapytania strony pod daną ścieżką, np.Browser Ajax Handler fetch("http://trilogy/local/api"). Funkcja zwraca treść odpowiedzi i opcjonalnie typ MIME. Bez funkcji obsługa jest usuwana.setUstawia, ile razy na sekundę strona się przerysowuje (1-240, domyślnie 60). Mniej klatek to mniej pracy procesora, na przykład dla rzadko zmienianego HUD-a; więcej klatek daje płynniejsze animacje na monitorach powyżej 60 Hz.Browser Frame Rate setUdostępnia stronie lokalnej funkcję Lua. W JavaScripcie wywołujesz ją przezBrowser Function await trilogy.call("nazwa", ...)i dostajesz jej wynik.setUstawia właściwość przeglądarki. Obsługiwana jestBrowser Property "mobile":"1"włącza widok telefonu.setWstrzymuje albo wznawia rysowanie strony. Wstrzymana strona nie obciąża procesora, gdy jej nie widać.Browser Rendering Paused setUstawia głośność jednej przeglądarki albo, gdy podasz tylko liczbę, wszystkich przeglądarek.Browser Volume setUstawia powiększenie strony (0.25-5,Browser Zoom 1to 100%).toggleOtwiera albo zamyka narzędzia deweloperskie strony. WymagaBrowser Dev Tools setDevelopmentMode(true, true)i"browser_devtools": truewserver-config.json.triggerWysyła zdarzenie z Lua do strony lokalnej. W JavaScripcie odbierasz je przezBrowser Event trilogy.on("nazwa", fn), bez sklejania kodu w napisie.
Zdarzenia klienta 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.