md_Docs_unity-integration The SpicyPixel.Threading.Unity.dll assembly provides functionality to integrate the Fiber and Task features of the Concurrency Kit with the Unity coroutine scheduler. MonoBehaviour Extensions Using ConcurrentBehaviour The ConcurrentBehavior class extends MonoBehaviour with additional properties to make it easy to access the scheduler associated with the behaviour. publicclassMyBehaviour:ConcurrentBehaviour { //IfyourcoderequiresAwake(),alwaysoverridethebase //becausethisiswheretheschedulersaresetuptoensure //thecorrectthreadisselected. overridevoidAwake() { base.Awake(); //Docustomlogic } voidUpdate() { taskFactory.StartNew(()=>DoWorkOnUnityThread()). ContinueWith((t)=>DoMoreWorkOnUnityThread(),taskScheduler); } } Managing scheduler creation If it is not convenient to extend your behaviour from ConcurrentBehavior, you can create factory and scheduler instances by invoking one of the extension methods in UnityTaskExtensions. publicclassMyBehaviour:MonoBehaviour { privateTaskFactorycustomTaskFactory; voidAwake() { customTaskFactory=this.CreateTaskFactory(); } voidUpdate() { customTaskFactory.StartNew(()=>DoWorkOnUnityThread()). ContinueWith((t)=>DoMoreWorkOnUnityThread(),customTaskFactory.Scheduler); } } Shared factory You can use UnityTaskFactory to access a shared factory instance which ultimately relies on the shared ConcurrentBehavior instance. publicclassMyBehaviour:MonoBehaviour { voidUpdate() { UnityTaskFactory.Default.StartNew(()=>DoWorkOnUnityThread()). ContinueWith((t)=>DoMoreWorkOnUnityThread(),UnityTaskScheduler.Default); } } Synchronization Context The UnitySynchronizationContext is a convenient way to integrate with code which relies on a SynchronizationContext or to post operations back to the calling thread in a scheduler agnostic manner. publicclassMyBehaviour:MonoBehaviour { voidAwake() { //Installthisonceatstartupinasinglebehaviourto //initializethecontextforthemainthread. SynchronizationContext.SetSynchronizationContext( UnitySynchronizationContext.SharedInstance); } //ThisexamplemethodmightbeinvokedbysomethingfromtheUnitythread //butwhichneedstoprocessresultsonatimer. voidProcessResults() { //Savethecurrentthread'ssynccontextbeforeweenterthetimer //sowecanuseitforcallback. varsyncContext=SynchronizationContext.Current; //Startatimer newTimer(TimerCallback,syncContext,TimeSpan.FromSeconds(3),TimeSpan.Zero); } //Dosomethingonatimerthread voidTimerCallback(objectstate) { //Getthesynccontextforthethreadthatcreated //thetimer.Technicallywecouldhavereferenced //UnitySynchronizationContext.SharedInstancesince //weknowthatisthethreadwewanttosendbackto, //butthisisthetypicalpatternyouwouldusetowrite //scheduleragnosticcode. varsyncContext=stateasSynchronizationContext; //Wearerunninginatimerthreadhere. //Now,runsomethingbackonthethreadthatstartedthetimer syncContext.Send((moreState)=>{ Debug.Log("BackontheUnitythread"); },null); } }