|
|
(4 intermediate revisions by 2 users not shown) |
Line 1: |
Line 1: |
− | The SHost class represents the scripting runtime.
| + | This page has moved to: https://docs.sine.space/v/scripting/client-scripting/scene/shost |
− | | + | |
− | ==Members==
| + | |
− | {{ScriptFunction|void|InvokeEvent|(string name);|Invokes a UnityEvent attached to the Scripting Runtime component this script is executing in.|
| + | |
− | function InvokeExample()<br>
| + | |
− | Space.Log("Invoke Event");<br>
| + | |
− | end<br>
| + | |
− | ''--Attach the upon function to Scripting Runtime/Unity Interfaces/Events,Named "InvokeExample.''<br><br>
| + | |
− | Space.Host.InvokeEvent("InvokeExample");<br>
| + | |
− | ''--print "Invoke Event" to the console.''
| + | |
− | }}
| + | |
− | | + | |
− | {{ScriptFunction|void|Stop|();|Pauses the current script until it is manually restarted, at the end of the current function/method; consider using return as well.|5=
| + | |
− | local trans=Space.Host.ExecutingObject;<br>
| + | |
− | trans.SubscribeToEvents();<br><br>
| + | |
− | function Running()<br>
| + | |
− | Space.Log("Running")<br>
| + | |
− | end<br><br>
| + | |
− | trans.OnUpdate(Running)<br><br>
| + | |
− | Space.Host.InvokeDelayed(function()<br>
| + | |
− | Space.Log("Stop")<br>
| + | |
− | Space.Host.Stop()<br>
| + | |
− | end,5)<br><br>
| + | |
− | ''--After print the "Stop","Running" won't display anymore.''
| + | |
− | }}
| + | |
− | | + | |
− | {{ScriptFunction|SGameObject|ExecutingObject|{ get; }|Returns the SGameObject this script is attached to.|5=
| + | |
− | local obj=Space.Host.ExecutingObject;<br>
| + | |
− | Space.Log(obj.Name);<br>
| + | |
− | ''--print object name to the console.''
| + | |
− | }}
| + | |
− | | + | |
− | {{ScriptFunction|string|Language|{ get; }|Returns the English name for the users language, e.g. 'English', 'French', 'Chinese'|
| + | |
− | Space.Log(Space.Host.Language);<br>
| + | |
− | ''--print current system language in English.''
| + | |
− | }}
| + | |
− | | + | |
− | {{ScriptFunction|void|StartCoroutine|(DynValue func);|Executes the specified function as a coroutine.|
| + | |
− | local function myCoroutine()
| + | |
− | <br> -- The yield statement is a special kind of return, that ensures that the function will continue from the line once the coroutine resumes.
| + | |
− | <br> -- Placing a float value inside of the yield will result in a delayed execution.
| + | |
− | <br> -- Example: coroutine.yield(0.5) will wait 0.5 seconds before continuing the execution of the coroutine.
| + | |
− | <br>
| + | |
− | <br> -- This will print the current players active time.
| + | |
− | <br> Space.Log(Space.Time);
| + | |
− | <br>
| + | |
− | <br> -- Execution of this coroutine will be halted for 10 seconds.
| + | |
− | <br> coroutine.yield(10);
| + | |
− | <br>
| + | |
− | <br> -- This will print the current players active time, which will be 10 seconds greater then the previous as a result of the yield
| + | |
− | <br> Space.Log(Space.Time);
| + | |
− | <br>end
| + | |
− | <br>
| + | |
− | <br>Space.Host.StartCoroutine(myCoroutine);
| + | |
− | <br>
| + | |
− | }}
| + | |
− | | + | |
− | {{ScriptFunction|void|InvokeDelayed|(Closure c, float delay)|Invoke the closure after the delayed time.|
| + | |
− | Space.Host.InvokeDelayed(function()<br>
| + | |
− | Space.Log("InvokeDelayed")<br>
| + | |
− | end,5)<br>
| + | |
− | ''--print "InvokeDelayed" after 5 seconds.''
| + | |
− | }}
| + | |
− | | + | |
− | {{ScriptFunction|bool|ReferenceExists|(string name)|Return true when the reference object exists and is not empty.|
| + | |
− | Space.Log(Space.Host.ReferenceExists("obj"));<br>
| + | |
− | ''--print "false" to console if didn't set the object named "obj" to the Object Reference.''
| + | |
− | }}
| + | |
− | | + | |
− | {{ScriptFunction|bool|ReferenceExistsAndNotEmpty|(string name)|Return true when the reference object exists and is not empty.|
| + | |
− | Space.Log(Space.Host.ReferenceExistsAndNotEmpty("obj"));<br>
| + | |
− | ''--print "false" to console if didn't set the object named "obj" to the Object References or attach the reference to "obj".''
| + | |
− | }}
| + | |
− | | + | |
− | {{Scripting Navbox}}
| + | |