Exports
Exports
Quattro export lato client, per altre risorse che necessitano di leggere o modificare il carburante di un veicolo. Questa pagina documenta esclusivamente ciò che esiste realmente nella risorsa.
local fuel = exports['bupa-fuel']:GetFuel(vehicle)
exports['bupa-fuel']:SetFuel(vehicle, 75.0)
local kind = exports['bupa-fuel']:GetFuelType(vehicle)
local ev = exports['bupa-fuel']:IsElectric(vehicle)| Export | Argomenti | Restituisce |
|---|---|---|
GetFuel |
vehicle (handle entità) |
Il livello di carburante come numero, da 0.0 a 100.0 |
SetFuel |
vehicle, level (numero) |
Nulla |
GetFuelType |
vehicle (handle entità) |
Una stringa chiave del carburante — 'gasoline', 'diesel', 'premium', 'electric' |
IsElectric |
vehicle (handle entità) |
true o false |
Note
GetFuel restituisce 0.0 per un'entità non valida o inesistente. Se il veicolo non è mai stato visto prima, questa è la chiamata che genera il livello di Config.Consumption.SpawnFuel e lo scrive nello state bag; pertanto, la semplice lettura del carburante di un'auto nuova provvede ad assegnarglielo.
SetFuel limita il valore tra 0.0 e 100.0. Su un veicolo di rete scrive sullo state bag dell'entità, che si replica su ogni client; su uno locale imposta solo il livello nativo. Si tratta di una percentuale, non di litri — per i litri, moltiplica per la capacità del serbatoio della classe di quel veicolo.
GetFuelType risolve nello stesso ordine della pompa: la lista elettrica, poi Config.VehicleFuel.Model, quindi la tabella delle classi, con fallback su 'gasoline'.
IsElectric è un'abbreviazione per GetFuelType(vehicle) == 'electric'.
Il carburante viene replicato tramite lo state bag fuel sull'entità del veicolo. Qualsiasi risorsa che desideri monitorare le variazioni di carburante senza ricorrere al polling può aggiungere il proprio AddStateBagChangeHandler('fuel', ...) anziché chiamare GetFuel in un ciclo continuo.
Gestore dell'oggetto inventario
bupa-fuel.useJerryCan è il gestore di utilizzo dell'oggetto di ox_inventory per l'oggetto jerrycan. Viene fatto riferimento nella definizione dell'oggetto — non va chiamato direttamente.
client = { export = 'bupa-fuel.useJerryCan' }Su QBox, QB-Core e ESX l'oggetto utilizzabile viene registrato internamente dalla risorsa, quindi non è necessaria alcuna configurazione degli export.