GetUnsafeSystemRef<T>(SystemHandle)

Resolves the system handle to a reference to its underlying system instantiation.

阅读时间1 分钟

最后更新于 19 天前

Definition

Type: Method
Namespace: Unity.Entities
Assembly: UnityEngine.EntitiesModule


public ref T GetUnsafeSystemRef<T>(SystemHandle id) where T : unmanaged, ISystem

Parameters

id

SystemHandle

The system handle

Returns

Type	Description
T	A reference to the concrete ISystem compatible instance for this system

Remarks

This system reference is not guaranteed to be safe to use. If the system or world is destroyed then the reference becomes invalid and will likely lead to corrupted program state if used.

Generally, instead of public member data, prefer using component data for system level data that needs to be shared between systems or externally to them. This defines a data protocol for the system which is separated from the system functionality.

Private member data which is only used internally to the system is recommended.

GetUnsafeSystemRef

, though provided as a backdoor to system instance data, is not recommended for usage in production or any non-throwaway code, as it

encourages coupling of data and functionality
couples data to the system type with no direct path to decouple
does not provide lifetime or thread safety guarantees for data
does not provide lifetime or thread safety guarantees for system access through the returned ref

Unity Engine

User Manual

Script Reference