feat: IMaaContext & IMaaResource .GetNodeData()

MaaXYZ/MaaFramework#680

Author: moomiji

src/MaaFramework.Binding.Native/MaaContext.cs

@@ -88,6 +88,14 @@ public bool OverrideNext(string nodeName, IEnumerable<string> nextList)
         => MaaStringListBuffer.TrySetList(nextList, listBuffer
             => MaaContextOverrideNext(Handle, nodeName, listBuffer));
 
+    /// <inheritdoc/>
+    /// <remarks>
+    ///     Wrapper of <see cref="MaaContextGetNodeData"/>.
+    /// </remarks>
+    public bool GetNodeData(string nodeName, [MaybeNullWhen(false)][StringSyntax("Json")] out string data)
+        => MaaStringBuffer.TryGetValue(out data, buffer
+            => MaaContextGetNodeData(Handle, nodeName, buffer));
+
     /// <inheritdoc/>
     /// <remarks>
     ///     Wrapper of <see cref="MaaContextGetTaskId"/>.

src/MaaFramework.Binding.Native/MaaResource.cs

@@ -204,6 +204,14 @@ public bool OverrideNext(string nodeName, IEnumerable<string> nextList)
         => MaaStringListBuffer.TrySetList(nextList, listBuffer
             => MaaResourceOverrideNext(Handle, nodeName, listBuffer));
 
+    /// <inheritdoc/>
+    /// <remarks>
+    ///     Wrapper of <see cref="MaaResourceGetNodeData"/>.
+    /// </remarks>
+    public bool GetNodeData(string nodeName, [MaybeNullWhen(false)][StringSyntax("Json")] out string data)
+        => MaaStringBuffer.TryGetValue(out data, buffer
+            => MaaResourceGetNodeData(Handle, nodeName, buffer));
+
     /// <inheritdoc/>
     /// <remarks>
     ///     Wrapper of <see cref="MaaResourceStatus"/>.

src/MaaFramework.Binding.UnitTests/Test_Custom.cs

@@ -56,6 +56,10 @@ public bool Analyze(in IMaaContext context, in AnalyzeArgs args, in AnalyzeResul
             Assert.AreEqual(
                 context.TaskJob.Id, cloneContext.TaskJob.Id);
 
+            Assert.IsFalse(
+                context.GetNodeData(DiffEntry, out var data));
+            Assert.IsNull(data);
+
             var recognitionDetail =
                 context.RunRecognition(DiffEntry, args.Image, DiffParam);
             Assert.IsNotNull(
@@ -68,6 +72,17 @@ public bool Analyze(in IMaaContext context, in AnalyzeArgs args, in AnalyzeResul
             Assert.IsTrue(
                 cloneContext.OverrideNext(DiffEntry, [DiffEntry]));
 
+            Assert.IsTrue(
+                cloneContext.GetNodeData(DiffEntry, out data));
+            Assert.IsNotNull(data);
+            Assert.IsTrue(
+                data.Contains($"\"next\":[\"{DiffEntry}\"]"));
+
+            Assert.IsTrue(
+                context.GetNodeData(DiffEntry, out data));
+            Assert.IsFalse(
+                data.Contains($"\"next\":[\"{DiffEntry}\"]"));
+
             Assert.IsTrue(
                 recognitionDetail.HitBox.TryCopyTo(results.Box));
             Assert.IsTrue(

src/MaaFramework.Binding.UnitTests/Test_IMaaResource.cs

@@ -74,14 +74,21 @@ public void Interface_AppendBundle_IsLoaded(MaaTypes type, IMaaResource maaResou
 
     [TestMethod]
     [MaaData(MaaTypes.All, nameof(Data))]
-    public void Interface_OverridePipeline_OverrideNext(MaaTypes type, IMaaResource maaResource)
+    public void Interface_OverridePipeline_OverrideNext_GetNodeData(MaaTypes type, IMaaResource maaResource)
     {
         var DiffParam = Custom.DiffParam;
         var DiffEntry = Custom.DiffEntry;
         Assert.IsTrue(
             maaResource.OverridePipeline(DiffParam));
         Assert.IsTrue(
             maaResource.OverrideNext(DiffEntry, [DiffEntry]));
+        Assert.IsTrue(
+            maaResource.GetNodeData(DiffEntry, out var data));
+
+        Assert.IsNotNull(
+            data);
+        Assert.IsTrue(
+            data.Contains($"\"next\":[\"{DiffEntry}\"]"));
     }
 
     private static void Interface_IMaaPost_Success(MaaJob job)

src/MaaFramework.Binding/IMaaContext.cs

@@ -64,6 +64,14 @@ public interface IMaaContext : ICloneable
     /// <returns><see langword="true"/> if the operation was executed successfully; otherwise, <see langword="false"/>.</returns>
     bool OverrideNext(string nodeName, IEnumerable<string> nextList);
 
+    /// <summary>
+    ///     Gets the node data from the <see cref="IMaaContext"/> by node name.
+    /// </summary>
+    /// <param name="nodeName">The node name.</param>
+    /// <param name="data">The node data.</param>
+    /// <returns><see langword="true"/> if the operation was executed successfully; otherwise, <see langword="false"/>.</returns>
+    bool GetNodeData(string nodeName, [MaybeNullWhen(false)][StringSyntax("Json")] out string data);
+
     /// <summary>
     ///     Gets the task job from the <see cref="IMaaContext"/>.
     /// </summary>

src/MaaFramework.Binding/IMaaResource.cs

@@ -1,5 +1,6 @@
 using MaaFramework.Binding.Abstractions;
 using MaaFramework.Binding.Custom;
+using System.Diagnostics.CodeAnalysis;
 
 namespace MaaFramework.Binding;
 
@@ -74,6 +75,14 @@ public interface IMaaResource : IMaaCommon, IMaaOption<ResourceOption>, IMaaPost
     /// <returns><see langword="true"/> if the operation was executed successfully; otherwise, <see langword="false"/>.</returns>
     bool OverrideNext(string nodeName, IEnumerable<string> nextList);
 
+    /// <summary>
+    ///     Gets the node data from the <see cref="IMaaResource"/> by node name.
+    /// </summary>
+    /// <param name="nodeName">The node name.</param>
+    /// <param name="data">The node data.</param>
+    /// <returns><see langword="true"/> if the operation was executed successfully; otherwise, <see langword="false"/>.</returns>
+    bool GetNodeData(string nodeName, [MaybeNullWhen(false)][StringSyntax("Json")] out string data);
+
     /// <summary>
     ///     Gets whether the <see cref="IMaaResource"/> is fully loaded.
     /// </summary>