mirror of
https://github.com/MirrorNetworking/Mirror.git
synced 2024-11-18 19:10:32 +00:00
35fee94d56
* Moved doc files to docfx folder * load csproj * doc generation * Run docfx * Add docfx * Deploy docs to mirror-networking.com * use deploy phase * deploy whole generated site * Fixed the semantic release command * Is last \ required? * show debug log * using lftp for site deploy * Testing lftp * Show current folder * try -e command option * Show me the files * use plain ftp * use choco install instead of cinst * fix ssl certificate validation * fix username * Upload site to xmldocs folder * no need to archive docs * No need for debug output * Fix file permissions * show me .htaccess * Show me contents * Wipe out folder to fix permissions * Set file permissions * Fix file permissions * complete toc list * Migrated intro page * Remove old docs * Update link to docs * Add link to github * Only update docs for stuff in master * This is a powershell command * Update doc/articles/Concepts/Communications/RemoteActions.md * Update doc/articles/Concepts/VisibilityCustom.md * Update doc/articles/Concepts/Authority.md * Update doc/articles/Concepts/GameObjects/SpawnObjectCustom.md * Update doc/articles/Concepts/Authority.md * Update doc/articles/Classes/SyncVars.md * No need to run semver twice
46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# SyncVar Hook
|
|
|
|
The hook attribute can be used to specify a function to be called when the SyncVar changes value on the client. This ensures that all clients receive the proper variables from other clients.
|
|
|
|
- The Hook method must have a single parameter of the same type as the SyncVar property. This parameter should have a unique name, e.g. newValue.
|
|
|
|
- Do not try to set the property value from inside the hook. The property value will be updated after the hook completes.
|
|
|
|
- Reference the hook parameter inside the hook to use the new value. Referencing the property value will be the old value, in case you need to compare.
|
|
|
|
Below is a simple example of assigning a random color to each player when they're spawned on the server. All clients will see all players in the correct colors, even if they join later.
|
|
|
|
```cs
|
|
using UnityEngine;
|
|
using UnityEngine.Networking;
|
|
|
|
public class PlayerController : NetworkBehaviour
|
|
{
|
|
public override void OnStartServer()
|
|
{
|
|
base.OnStartServer();
|
|
playerColor = Random.ColorHSV(0f, 1f, 1f, 1f, 0.5f, 1f);
|
|
}
|
|
|
|
[SyncVar(hook = nameof(SetColor))]
|
|
Color playerColor = Color.black;
|
|
|
|
// Unity makes a clone of the Material every time GetComponent<Renderer>().material is used.
|
|
// Cache it here and Destroy it in OnDestroy to prevent a memory leak.
|
|
Material cachedMaterial;
|
|
|
|
void SetColor(Color color)
|
|
{
|
|
if (cachedMaterial == null)
|
|
cachedMaterial = GetComponent<Renderer>().material;
|
|
|
|
cachedMaterial.color = color;
|
|
}
|
|
|
|
void OnDestroy()
|
|
{
|
|
Destroy(cachedMaterial);
|
|
}
|
|
}
|
|
```
|