Minor documentation fix
This commit is contained in:
@ -16,7 +16,7 @@ namespace RageCoop.Client.Scripting
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
public int Hash { get; set; }
|
public int Hash { get; set; }
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Arguments
|
/// Supported types: byte, short, ushort, int, uint, long, ulong, float, bool, string, Vector3, Quaternion
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public List<object> Args { get; set; }
|
public List<object> Args { get; set; }
|
||||||
}
|
}
|
||||||
@ -223,8 +223,7 @@ namespace RageCoop.Client.Scripting
|
|||||||
/// Send an event and data to the server.
|
/// Send an event and data to the server.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="eventHash">An unique identifier of the event</param>
|
/// <param name="eventHash">An unique identifier of the event</param>
|
||||||
/// <param name="args">The objects conataing your data, supported types:
|
/// <param name="args">The objects conataing your data, see <see cref="CustomEventReceivedArgs"/> for a list of supported types</param>
|
||||||
/// byte, short, ushort, int, uint, long, ulong, float, bool, string.</param>
|
|
||||||
public static void SendCustomEvent(int eventHash, List<object> args)
|
public static void SendCustomEvent(int eventHash, List<object> args)
|
||||||
{
|
{
|
||||||
var p = new Packets.CustomEvent()
|
var p = new Packets.CustomEvent()
|
||||||
|
@ -8,12 +8,12 @@ namespace RageCoop.Client.Scripting
|
|||||||
public abstract class ClientScript
|
public abstract class ClientScript
|
||||||
{
|
{
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// This method would be called from main thread shortly after all scripts have been loaded.
|
/// This method would be called from background thread, call <see cref="API.QueueAction(System.Action)"/> to dispatch it to main thread.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public abstract void OnStart();
|
public abstract void OnStart();
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// This method would be called from main thread when the client disconnected from the server, you MUST terminate all background jobs/threads in this method.
|
/// This method would be called from background thread when the client disconnected from the server, you MUST terminate all background jobs/threads in this method.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public abstract void OnStop();
|
public abstract void OnStop();
|
||||||
|
|
||||||
|
@ -206,7 +206,7 @@ namespace RageCoop.Server.Scripting
|
|||||||
/// <param name="name">The name of the command (Example: "test" for "/test")</param>
|
/// <param name="name">The name of the command (Example: "test" for "/test")</param>
|
||||||
/// <param name="usage">How to use this message (argsLength required!)</param>
|
/// <param name="usage">How to use this message (argsLength required!)</param>
|
||||||
/// <param name="argsLength">The length of args (Example: "/message USERNAME MESSAGE" = 2) (usage required!)</param>
|
/// <param name="argsLength">The length of args (Example: "/message USERNAME MESSAGE" = 2) (usage required!)</param>
|
||||||
/// <param name="callback">Create a new function!</param>
|
/// <param name="callback">A callback to invoke when the command received.</param>
|
||||||
public void RegisterCommand(string name, string usage, short argsLength, Action<CommandContext> callback)
|
public void RegisterCommand(string name, string usage, short argsLength, Action<CommandContext> callback)
|
||||||
{
|
{
|
||||||
Server.RegisterCommand(name, usage, argsLength, callback);
|
Server.RegisterCommand(name, usage, argsLength, callback);
|
||||||
@ -215,7 +215,7 @@ namespace RageCoop.Server.Scripting
|
|||||||
/// Register a new command chat command (Example: "/test")
|
/// Register a new command chat command (Example: "/test")
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="name">The name of the command (Example: "test" for "/test")</param>
|
/// <param name="name">The name of the command (Example: "test" for "/test")</param>
|
||||||
/// <param name="callback">Create a new function!</param>
|
/// <param name="callback">A callback to invoke when the command received.</param>
|
||||||
public void RegisterCommand(string name, Action<CommandContext> callback)
|
public void RegisterCommand(string name, Action<CommandContext> callback)
|
||||||
{
|
{
|
||||||
Server.RegisterCommand(name, callback);
|
Server.RegisterCommand(name, callback);
|
||||||
@ -249,7 +249,7 @@ namespace RageCoop.Server.Scripting
|
|||||||
/// Send an event and data to the specified clients. Use <see cref="Client.SendCustomEvent(int, List{object})"/> if you want to send event to individual client.
|
/// Send an event and data to the specified clients. Use <see cref="Client.SendCustomEvent(int, List{object})"/> if you want to send event to individual client.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="name">The name of the event, will be hashed to an int. For optimal performence, you should hash it in a static contructor inside the shared library, then call <see cref="SendCustomEvent(int, List{object}, List{Client})"/>.</param>
|
/// <param name="name">The name of the event, will be hashed to an int. For optimal performence, you should hash it in a static contructor inside the shared library, then call <see cref="SendCustomEvent(int, List{object}, List{Client})"/>.</param>
|
||||||
/// <param name="args">The objects conataing your data, supported types: byte, short, ushort, int, uint, long, ulong, float, bool, string.</param>
|
/// <param name="args">See <see cref="CustomEventReceivedArgs"/> for a list of supported types.</param>
|
||||||
/// <param name="targets">The target clients to send. Leave it null to send to all clients</param>
|
/// <param name="targets">The target clients to send. Leave it null to send to all clients</param>
|
||||||
public void SendCustomEvent(string name, List<object> args = null, List<Client> targets = null)
|
public void SendCustomEvent(string name, List<object> args = null, List<Client> targets = null)
|
||||||
{
|
{
|
||||||
@ -269,7 +269,7 @@ namespace RageCoop.Server.Scripting
|
|||||||
/// Send an event and data to the specified clients. Use <see cref="Client.SendCustomEvent(int, List{object})"/> if you want to send event to individual client.
|
/// Send an event and data to the specified clients. Use <see cref="Client.SendCustomEvent(int, List{object})"/> if you want to send event to individual client.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="eventHash">An unique identifier of the event, you can use <see cref="CustomEvents.Hash(string)"/> to get it from a string</param>
|
/// <param name="eventHash">An unique identifier of the event, you can use <see cref="CustomEvents.Hash(string)"/> to get it from a string</param>
|
||||||
/// <param name="args">The objects conataing your data, supported types: byte, short, ushort, int, uint, long, ulong, float, bool, string.</param>
|
/// <param name="args">The objects conataing your data, see <see cref="Scripting.CustomEventReceivedArgs.Args"/> for supported types.</param>
|
||||||
/// <param name="targets">The target clients to send. Leave it null to send to all clients</param>
|
/// <param name="targets">The target clients to send. Leave it null to send to all clients</param>
|
||||||
public void SendCustomEvent(int eventHash,List<object> args=null,List<Client> targets=null)
|
public void SendCustomEvent(int eventHash,List<object> args=null,List<Client> targets=null)
|
||||||
{
|
{
|
||||||
@ -288,7 +288,7 @@ namespace RageCoop.Server.Scripting
|
|||||||
/// Register an handler to the specifed event hash, one event can have multiple handlers.
|
/// Register an handler to the specifed event hash, one event can have multiple handlers.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="hash">An unique identifier of the event, you can hash your event name with <see cref="Core.Scripting.CustomEvents.Hash(string)"/></param>
|
/// <param name="hash">An unique identifier of the event, you can hash your event name with <see cref="Core.Scripting.CustomEvents.Hash(string)"/></param>
|
||||||
/// <param name="handler">An handler to be invoked when the event is received from the server. This will be invoked from main thread.</param>
|
/// <param name="handler">An handler to be invoked when the event is received from the server.</param>
|
||||||
public void RegisterCustomEventHandler(int hash,Action<CustomEventReceivedArgs> handler)
|
public void RegisterCustomEventHandler(int hash,Action<CustomEventReceivedArgs> handler)
|
||||||
{
|
{
|
||||||
List<Action<CustomEventReceivedArgs>> handlers;
|
List<Action<CustomEventReceivedArgs>> handlers;
|
||||||
|
@ -30,12 +30,14 @@ namespace RageCoop.Server.Scripting
|
|||||||
/// The <see cref="Client"/> that triggered this event
|
/// The <see cref="Client"/> that triggered this event
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public Client Sender { get; set; }
|
public Client Sender { get; set; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The event hash
|
/// The event hash
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public int Hash { get; set; }
|
public int Hash { get; set; }
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// The arguments of this event
|
/// Supported types: byte, short, ushort, int, uint, long, ulong, float, bool, string, Vector3, Quaternion, ServerPed, ServerVehicle, ServerProp
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public List<object> Args { get; set; }
|
public List<object> Args { get; set; }
|
||||||
}
|
}
|
||||||
|
@ -24,7 +24,7 @@ namespace RageCoop.Server
|
|||||||
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Pass the value as an argument in <see cref="Scripting.API.SendCustomEvent(int, List{object}, List{Client})"/> or <see cref="Client.SendCustomEvent(int, object[])"/> to convert this object to handle at client side.
|
/// Pass this as an argument in CustomEvent or NativeCall to convert this object to handle at client side.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
public Tuple<byte,byte[]> Handle
|
public Tuple<byte,byte[]> Handle
|
||||||
{
|
{
|
||||||
@ -83,9 +83,8 @@ namespace RageCoop.Server
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Pass the value as an argument in <see cref="Scripting.API.SendCustomEvent(int, List{object}, List{Client})"/> or <see cref="Client.SendCustomEvent(int, object[])"/> to convert this object to handle at client side.
|
/// Pass this as an argument in CustomEvent or NativeCall to convert this object to handle at client side.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <returns></returns>
|
|
||||||
public Tuple<byte, byte[]> Handle
|
public Tuple<byte, byte[]> Handle
|
||||||
{
|
{
|
||||||
get
|
get
|
||||||
@ -141,9 +140,8 @@ namespace RageCoop.Server
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Pass the value as an argument in <see cref="Scripting.API.SendCustomEvent(int, List{object}, List{Client})"/> or <see cref="Client.SendCustomEvent(int, object[])"/> to convert this object to handle at client side.
|
/// Pass this as an argument in CustomEvent or NativeCall to convert this object to handle at client side.
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <returns></returns>
|
|
||||||
public Tuple<byte, byte[]> Handle
|
public Tuple<byte, byte[]> Handle
|
||||||
{
|
{
|
||||||
get{
|
get{
|
||||||
|
Reference in New Issue
Block a user