https://github.com/PimDeWitte/UnityMainThreadDispatcher

A simple, thread-safe way of executing actions (Such as UI manipulations) on the Unity Main Thread
https://github.com/PimDeWitte/UnityMainThreadDispatcher

Last synced: 4 months ago
JSON representation

A simple, thread-safe way of executing actions (Such as UI manipulations) on the Unity Main Thread

• Host: GitHub
• URL: https://github.com/PimDeWitte/UnityMainThreadDispatcher
• Owner: PimDeWitte
• License: apache-2.0
• Created: 2016-04-01T23:42:23.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2023-08-17T19:31:56.000Z (10 months ago)
• Last Synced: 2024-01-14T18:59:42.476Z (5 months ago)
• Language: C#
• Homepage:
• Size: 27.3 KB
• Stars: 763
• Watchers: 29
• Forks: 148
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-unity3d - UnityMainThreadDispatcher - A simple, thread-safe way of executing actions (Such as UI manipulations) on the Unity Main Thread (Open Source Repositories / Theading)
• awesome-opensource-unity - UnityMainThreadDispatcher - A simple, thread-safe way of executing actions (Such as UI manipulations) on the Unity Main Thread. (Open Source Packages / Utilities)
• AwesomeUnityCommunity - UnityMainThreadDispatcher - A simple, thread-safe way of executing actions (Such as UI manipulations) on the Unity Main Thread. (:pencil2: Scripting <a name="scripting"></a> / Coroutines / Threading <a name="coroutines-threading"></a>)
• awesome-unity - UnityMainThreadDispatcher - A simple, thread-safe way of executing actions (Such as UI manipulations) on the Unity Main Thread. (:pencil2: Scripting <a name="scripting"></a> / Coroutines / Threading <a name="coroutines-threading"></a>)

README

        
# UnityMainThreadDispatcher

A thread-safe way of dispatching IEnumerator functions to the main thread in unity. Useful for calling UI functions and other actions that Unity limits to the main thread from different threads. Initially written for Firebase Unity but now used across the board!

### Version

1.0 - Tested and functional in one or more production applications, including those from major companies. 

### Installation

No dependencies needed other than Unity. This script was created in Unity 5.3, and has been tested in 5.3, 5.4, and 5.5 by the creators, but is being used across many more versions. If something breaks, let us know!

1. Download the UnityMainThreadDispatcher prefab and add it to your scene, or simple create an empty GameObject, call it UnityMainThreadDispatcher.

2. Download the UnityMainThreadDispatcher.cs script and add it to your prefab

3. You can now dispatch objects to the main thread in Unity.

### Usage

```C#

	public IEnumerator ThisWillBeExecutedOnTheMainThread() {

		Debug.Log ("This is executed from the main thread");

		yield return null;

	}

	public void ExampleMainThreadCall() {

		UnityMainThreadDispatcher.Instance().Enqueue(ThisWillBeExecutedOnTheMainThread()); 

	}

```

OR

```C#

	UnityMainThreadDispatcher.Instance().Enqueue(() => Debug.Log ("This is executed from the main thread"));

```

### Development

Want to contribute? Great! If you find a bug or want to make improvements, simply fork the repo and make a pull request with your changes on your own fork.

Also - I'm looking for additional maintainers who are still actively using this in production as I now run a startup and am not actively doing engineering work anymore. 

### Author

@PimDeWitte