Agency-Seatbelt V2 Exports & API
Cinto standalone para FiveM, reconstruído de raiz para a 2.0.0.
01Exports do cliente
| Export | Descrição |
|---|---|
isSeatbeltOn() | Devolve true enquanto o cinto do jogador local está apertado, quer o tenha apertado ele próprio, quer o carro. |
enableSeatbelt() | Aperta o cinto do jogador local com o som e o aviso habituais. |
disableSeatbelt() | Desaperta o cinto do jogador local com o som e o aviso habituais. |
toggleSeatbelt() | Alterna o cinto do jogador local. Devolve true quando o estado mudou de facto, não o novo estado, para distinguir uma alternância recusada (sem veículo ou sem cinto nesse lugar) de uma que funcionou. |
isAutoBuckled() | Devolve true enquanto o cinto foi apertado pelo carro e não pelo jogador. |
autoBuckle(on: boolean) | Aperta ou desaperta o cinto como cinto automático, tal como faz um carro autónomo. |
getSeatbeltState() | Devolve uma tabela com o estado do cinto, se é automático, o lugar e o veículo. |
setSeatbeltEnabled(on: boolean) | Desliga ou liga todo o cinto para este jogador, para cenas cinemáticas ou situações de admin. |
isPlayerSeatbeltOn(serverId: number) | Devolve o estado do cinto de outro jogador, lido do state bag replicado. |
bucklesItselfVehicle(vehicle: number) | Indica se este veículo aperta ele próprio os ocupantes, pela lista de modelos ou pelo state bag agAuto. |
openSettings() | Abre o cartão de definições. |
closeSettings() | Fecha o cartão de definições. |
isSettingsOpen() | Indica se o cartão de definições está aberto. |
02Exports do servidor
| Export | Descrição |
|---|---|
isSeatbeltOn(source: number) | Devolve no servidor o estado do cinto de um jogador, lido do state bag replicado. |
getBuckledPlayers() | Devolve os ids de servidor de todos os jogadores com o cinto apertado. |
setSeatbelt(source: number, on: boolean) | Aperta ou desaperta a partir do servidor o cinto de um jogador. |
03Eventos
| Nome | Lado | Descrição |
|---|---|---|
Agency-HUD:seatbeltStateChanged | Cliente | Dispara a cada alteração com o novo estado. O Agency-HUD escuta-o; qualquer outro resource também pode. |
+Bom saber
Esta página lista os exports disponíveis fornecidos pelo Agency-Seatbelt para uso em outros recursos. Desenvolvedores podem usar esses exports do lado do cliente para controlar ou consultar o estado do cinto de segurança do jogador local. Nenhum export do lado do servidor é fornecido. Garanta que o Agency-Seatbelt esteja iniciado antes de qualquer recurso que use seus exports para evitar erros em tempo de execução ou comportamento indefinido.
- Apenas exports do lado do cliente
- O Agency-Seatbelt fornece quatro exports que são todos do lado do cliente. Estes permitem que scripts ativem, desativem, alternem ou verifiquem o status do cinto de segurança para o jogador local. Não há exports ou eventos do lado do servidor expostos por este recurso.
- Uso dentro de outros recursos
- Para usar esses exports, certifique-se de que o Agency-Seatbelt esteja iniciado antes de qualquer recurso dependente. Chame os exports diretamente de seus scripts cliente para integrar a funcionalidade do cinto de segurança ou verificações de status do HUD conforme necessário.
- Sem dependências ou SQL
- O Agency-Seatbelt não requer dependências externas nem configuração de SQL. Todos os recursos, incluindo funções de export, estão disponíveis imediatamente após iniciar o recurso.
?Perguntas frequentes
Existem exports do lado do servidor disponíveis para o Agency-Seatbelt?
Não, Agency-Seatbelt fornece apenas exports do lado do cliente. Não há exports ou eventos do lado do servidor expostos. Toda interação com o estado do cinto de segurança deve ser realizada a partir de scripts cliente usando os exports disponíveis.
O que acontece se eu chamar um export antes do Agency-Seatbelt ser iniciado?
Se você tentar usar um export antes do Agency-Seatbelt ser iniciado, o export não estará disponível e seu script pode gerar um erro ou falhar em funcionar como esperado. Sempre garanta que o Agency-Seatbelt esteja iniciado primeiro.
Preciso configurar alguma dependência ou importar SQL para usar esses exports?
Não, o Agency-Seatbelt não requer dependências ou importações SQL. Os exports estão disponíveis imediatamente após o recurso ser iniciado, e nenhuma configuração adicional é necessária.
Como verifico se o cinto de segurança do jogador local está afivelado a partir de outro script?
Você pode usar o export cliente isSeatbeltOn() para verificar se o cinto de segurança do jogador local está afivelado no momento. Chame esse export do seu script cliente para obter o status atual do cinto.