Události

From Neos Wiki
Jump to navigation Jump to search
This page is a translated version of the page API:Events and the translation is 100% complete.
Other languages:
English • ‎čeština • ‎日本語

OnAwake()

Tato funkce je volána pokaždé kdy e objekt/komponenta konstruován/konstruována na každé instanci klienta, ať už je vytvořen/vytvořena lokálně, synchronizován/synchronizována ze vzdálené lokace nebo načten/načtena.

Jakékoliv modifikace nejsou synchronizovány, a jako takové by měly být deterministické a nezáležet na žádném externím stavu. Jakékoliv přidávání/mazání v datovém modelu jsou zakázány během jejího provádění.

Je užitečná pro inicializaci defaultních hodnot pro synchronizaci elementů objektu/komponenty před načtením nebo provedením jakýchkoliv nedeterministických změn.

Může být také využita k nastavení jakýchkoliv lokálních hooků, událostí a pomocných objektů.

OnStart()

Tato funkce je volána pro všechny nově konstruované objekty/komponenty ve scéně během spouštěcí fáze cyklu aktualizace. Je volána pro kažřdého uživatele ve světě, ale jsou povoleny a synchronizovány jakékoliv změny stavu.

Je volának po každé konstrukci, ať už vytvořené lokálně, synchronizované nebo načtené.

OnAttach()

Tato funkce je volána když je komponenta připojena k objektu, než AttachComponent<T>()předá zpět kontrolu. Je volána pouze jedenkrát pro každou komponentu, když je poprvé vložena do datového modelu pro uživatele který ji do něj vložil.

Jakákoliv změna stavu je dovolena a synchronizována ostatním. Funkce není volána když je objekt načten nebo synchronizován ostatním.

Může být využita pro počáteční přípravu, kterou komponenta vyžaduje, která vyžaduje arbitrární změny na datovém modelu (tvorba nových objektů, připojování dalších komponent) nebo nedetrministickou inicializaci vlastností (jejich incializaci pomocí generátoru náhodných čísel).

OnCommonUpdate()

Tato funkce je volána pro každého uživatele v každém snímku. Může být využita pro provedení jakékoliv per-frame logiky.

Pokud chcete provést změny jen pro určitého uživatele, můžete využít property LocalUser ke kontrole, který uživatel aktuálně spouští kód, nebo LocalUser.IsHost pokud je chcete spouštět poze na hostu.

OnChanges()

Tato funkce je volána pokaždé když se něco změní na objektu/komponentě, pro každého uživatele kde ke změnám došlo. Změny mohou být buď lokální nebo vzdálené.

Funkce není volána ihned po změně, nýbrž v dávce potom co proběhnou veškeré ostatní aktualizace, tudíž pokud je změněno více věcí na komponentě/objektu během jednoho snímku, je funkce pro ně volána pouze jednou.

Toto je užitečné pro aktualizaci jakéhokoliv stavu, který závisí na jiných stavech nebo stavu komponenty, ale nemění se každá frame.