1. WebクライアントSDK

スクリプト クライアント

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このSDKは、アクションスクリプトを実行するためのScripts clientを提供します。

メモ

次のコード例のclient変数は、IMClientインスタンスを参照します。Web SDKを使用する場合、変数名は自由に選択できますが、ドキュメントではインスタンス化時にclientとも呼ばれます。

アクションスクリプトの例

次のActionスクリプトがpublishedされ、enabledされているとします。

// For simplicity, assume 'name' is always present
var name = Context.Data["name"].ToString();

Context.Result["message"] = $"Hello, {name}!";

このスクリプトは、Dataから "name" プロパティを取得し、Resultのmessageの下にhelloメッセージを設定します。

詳細については、「 スクリプトの作成」を参照してください。

SDKを使用したスクリプトの実行

上記のスクリプトの識別子fYaE4Q518ECLRtO2b3W-3Qがあるとします。SDKを使用すると、スクリプトを次のように実行できます。

// using Newtonsoft.Json.Linq;
// ...

var arguments = new JObject
{
  { "name", "world" } // Key: "name", value: "world"
};

var scriptIdentifier = "fYaE4Q518ECLRtO2b3W-3Q";
var result = await MClient.Scripts.ExecuteActionScriptAsync(scriptIdentifier, arguments);
MClient.Logger.Info(result["message"].ToString());

これにより、スクリプトが返したメッセージ ("Hello, world!" ) がログに記録されます。

ExecuteActionScriptAsyncによって返されるresultは、アクションスクリプトのContext.Resultオブジェクトと同じです。

この記事を改善するための提案がある場合は、 お知らせください!