Agency-Seatbelt V2 Eksporty & API
Pasy bezpieczeństwa standalone dla FiveM, przebudowane od podstaw dla wersji 2.0.0.
01Eksporty klienta
| Eksport | Opis |
|---|---|
isSeatbeltOn() | Zwraca true, gdy pas lokalnego gracza jest zapięty, niezależnie od tego, czy zapiął go sam, czy zrobił to samochód. |
enableSeatbelt() | Zapina pas lokalnego gracza ze standardowym dźwiękiem i informacją zwrotną. |
disableSeatbelt() | Odpina pas lokalnego gracza ze standardowym dźwiękiem i informacją zwrotną. |
toggleSeatbelt() | Przełącza pas lokalnego gracza. Zwraca true, gdy stan faktycznie uległ zmianie, a nie nowy stan, dzięki czemu można odróżnić odrzucone przełączenie (brak pojazdu lub brak pasa na tym miejscu) od udanego. |
isAutoBuckled() | Zwraca true, gdy pas został zapięty przez samochód, a nie przez gracza. |
autoBuckle(on: boolean) | Zapina lub odpina pas automatycznie, tak jak w autonomicznym pojeździe. |
getSeatbeltState() | Zwraca tabelę ze stanem zapięcia, informacją czy jest automatyczny, miejscem i pojazdem. |
setSeatbeltEnabled(on: boolean) | Wyłącza lub włącza cały pas bezpieczeństwa dla tego gracza, na potrzeby cutscenek lub sytuacji administratorskich. |
isPlayerSeatbeltOn(serverId: number) | Zwraca stan pasów innego gracza, odczytany ze zreplikowanego state bag. |
bucklesItselfVehicle(vehicle: number) | Zwraca, czy ten pojazd sam zapina pasy pasażerom, według listy modeli lub przez state bag agAuto. |
openSettings() | Otwiera kartę ustawień. |
closeSettings() | Zamyka kartę ustawień. |
isSettingsOpen() | Zwraca, czy karta ustawień jest otwarta. |
02Eksporty serwera
| Eksport | Opis |
|---|---|
isSeatbeltOn(source: number) | Zwraca stan pasów gracza na serwerze, odczytany ze zreplikowanego state bag. |
getBuckledPlayers() | Zwraca ID serwerowe każdego aktualnie zapiętego gracza. |
setSeatbelt(source: number, on: boolean) | Zapina lub odpina pas gracza z poziomu serwera. |
03Eventy
| Nazwa | Strona | Opis |
|---|---|---|
Agency-HUD:seatbeltStateChanged | Klient | Wywoływane przy każdej zmianie wraz z nowym stanem. Agency-HUD nasłuchuje tego zdarzenia, każdy inny zasób również może to robić. |
+Warto wiedzieć
Ta strona zawiera listę dostępnych exportów udostępnianych przez Agency-Seatbelt do użycia w innych zasobach. Deweloperzy mogą używać tych exportów po stronie klienta do kontrolowania lub sprawdzania stanu pasów bezpieczeństwa lokalnego gracza. Nie udostępniono żadnych exportów po stronie serwera. Upewnij się, że Agency-Seatbelt został uruchomiony przed każdym zasobem korzystającym z jego exportów, aby uniknąć błędów wykonania lub nieoczekiwanego zachowania.
- Tylko eksporty po stronie klienta
- Agency-Seatbelt udostępnia cztery eksporty działające po stronie clienta. Pozwalają one skryptom włączać, wyłączać, przełączać lub sprawdzać stan pasów lokalnego gracza. Ten zasób nie udostępnia żadnych eksportów ani zdarzeń server.
- Użycie w innych zasobach
- Aby korzystać z tych exportów, upewnij się, że Agency-Seatbelt jest uruchomiony przed jakimkolwiek zależnym resource. Wywołuj exporty bezpośrednio ze swoich skryptów klienckich, aby w razie potrzeby zintegrować funkcjonalność pasów bezpieczeństwa lub sprawdzanie statusu HUD.
- Brak zależności i SQL
- Agency-Seatbelt nie wymaga żadnych zewnętrznych zależności ani konfiguracji SQL. Wszystkie funkcje, w tym eksporty, są dostępne od razu po uruchomieniu zasobu.
?Często zadawane pytania
Czy dla Agency-Seatbelt dostępne są eksporty po stronie serwera?
Nie, Agency-Seatbelt udostępnia wyłącznie exporty po stronie klienta. Nie ma żadnych udostępnionych exportów ani eventów po stronie serwera. Cała interakcja ze stanem pasów bezpieczeństwa musi odbywać się ze skryptów klienta za pomocą dostępnych exportów.
Co się stanie, jeśli wywołam export przed uruchomieniem Agency-Seatbelt?
Jeśli spróbujesz użyć eksportu przed uruchomieniem Agency-Seatbelt, eksport nie będzie dostępny, a Twój skrypt może zgłosić błąd lub nie działać zgodnie z oczekiwaniami. Zawsze upewnij się, że Agency-Seatbelt jest uruchomiony jako pierwszy.
Czy muszę konfigurować jakiekolwiek zależności lub importować SQL, aby korzystać z tych eksportów?
Nie, Agency-Seatbelt nie wymaga żadnych zależności ani importu SQL. Exporty są dostępne natychmiast po uruchomieniu zasobu i nie jest wymagana żadna dodatkowa konfiguracja.
Jak z poziomu innego skryptu sprawdzić, czy lokalny gracz ma zapięty pas?
Możesz użyć client exportu isSeatbeltOn(), aby sprawdzić, czy pas lokalnego gracza jest aktualnie zapięty. Wywołaj ten export ze swojego skryptu klienckiego, aby pobrać aktualny stan pasów.