feat: support optional arguments

f27386e

9c5bc0e

Author: moomiji

src/MaaFramework.Binding.Native/MaaAgentClient.cs

@@ -106,6 +106,14 @@ public static MaaAgentClient Create(string identifier, MaaTasker maa)
         return client;
     }
 
+    /// <inheritdoc cref="CreateTcp(ushort, MaaResource)"/>
+    public static MaaAgentClient CreateTcp(MaaResource resource)
+        => CreateTcp(0, resource);
+
+    /// <inheritdoc cref="CreateTcp(ushort, MaaTasker)"/>
+    public static MaaAgentClient CreateTcp(MaaTasker maa)
+        => CreateTcp(0, maa);
+
     /// <summary>
     ///     Creates a <see cref="MaaAgentClient"/> instance with TCP connection.
     ///     <para>The callback (from resource) will be forwarded to the agent server.</para>

src/MaaFramework.Binding.Native/MaaContext.cs

@@ -159,26 +159,23 @@ public MaaContext(MaaContextHandle contextHandle, MaaTasker tasker)
     }
 
     /// <inheritdoc/>
-    public bool WaitFreezes(TimeSpan time, IMaaRectBuffer recognitionBox, [StringSyntax("Json")] string waitFreezesParam = "{}")
-        => WaitFreezes((MaaSize)time.TotalMilliseconds, (MaaRectBuffer)recognitionBox, waitFreezesParam);
+    public bool WaitFreezes(TimeSpan time = default, IMaaRectBuffer? recognitionBox = default, [StringSyntax("Json")] string waitFreezesParam = "{}")
+        => WaitFreezes((MaaSize)time.TotalMilliseconds, (MaaRectBuffer?)recognitionBox, waitFreezesParam);
 
     /// <inheritdoc cref="IMaaContext.WaitFreezes(TimeSpan, IMaaRectBuffer, string)"/>
-    public bool WaitFreezes(TimeSpan time, MaaRectBuffer recognitionBox, [StringSyntax("Json")] string waitFreezesParam = "{}")
+    public bool WaitFreezes(TimeSpan time = default, MaaRectBuffer? recognitionBox = default, [StringSyntax("Json")] string waitFreezesParam = "{}")
         => WaitFreezes((MaaSize)time.TotalMilliseconds, recognitionBox, waitFreezesParam);
 
     /// <inheritdoc/>
-    public bool WaitFreezes(MaaSize millisecondsTime, IMaaRectBuffer recognitionBox, [StringSyntax("Json")] string waitFreezesParam = "{}")
-        => WaitFreezes(millisecondsTime, (MaaRectBuffer)recognitionBox, waitFreezesParam);
+    public bool WaitFreezes(MaaSize millisecondsTime = 0, IMaaRectBuffer? recognitionBox = default, [StringSyntax("Json")] string waitFreezesParam = "{}")
+        => WaitFreezes(millisecondsTime, (MaaRectBuffer?)recognitionBox, waitFreezesParam);
 
     /// <inheritdoc cref="IMaaContext.WaitFreezes(MaaSize, IMaaRectBuffer, string)"/>
     /// <remarks>
     ///     Wrapper of <see cref="MaaContextWaitFreezes"/>.
     /// </remarks>
-    public bool WaitFreezes(MaaSize millisecondsTime, MaaRectBuffer recognitionBox, [StringSyntax("Json")] string waitFreezesParam = "{}")
-    {
-        ArgumentNullException.ThrowIfNull(recognitionBox);
-        return MaaContextWaitFreezes(Handle, millisecondsTime, recognitionBox.Handle, waitFreezesParam);
-    }
+    public bool WaitFreezes(MaaSize millisecondsTime = 0, MaaRectBuffer? recognitionBox = default, [StringSyntax("Json")] string waitFreezesParam = "{}")
+        => MaaContextWaitFreezes(Handle, millisecondsTime, recognitionBox?.Handle ?? MaaRectHandle.Zero, waitFreezesParam);
 
     /// <inheritdoc/>
     /// <remarks>

src/MaaFramework.Binding/IMaaContext.cs

@@ -87,7 +87,7 @@ public interface IMaaContext : ICloneable
     ///     <paramref name="millisecondsTime"/> and <paramref name="waitFreezesParam"/>.time are mutually exclusive.
     /// </remarks>
     /// <exception cref="ArgumentNullException"/>
-    bool WaitFreezes(MaaSize millisecondsTime, IMaaRectBuffer recognitionBox, [StringSyntax("Json")] string waitFreezesParam = "{}");
+    bool WaitFreezes(MaaSize millisecondsTime = 0, IMaaRectBuffer? recognitionBox = default, [StringSyntax("Json")] string waitFreezesParam = "{}");
 
     /// <param name="time">The wait time.</param>
     /// <param name="recognitionBox">The recognition hit box, used when target is Self to calculate ROI.</param>
@@ -97,7 +97,7 @@ public interface IMaaContext : ICloneable
     /// </remarks>
     /// <inheritdoc cref="WaitFreezes(ulong, IMaaRectBuffer, string)"/>
     /// <exception cref="ArgumentNullException"/>
-    bool WaitFreezes(TimeSpan time, IMaaRectBuffer recognitionBox, [StringSyntax("Json")] string waitFreezesParam = "{}");
+    bool WaitFreezes(TimeSpan time = default, IMaaRectBuffer? recognitionBox = default, [StringSyntax("Json")] string waitFreezesParam = "{}");
 
     /// <summary>
     ///     Overrides a pipeline.