EmitWithId#

ExportMessage.EmitWithId(messageName, value, targetId)#

メッセージ」をすべてのクライアント上の空間内にある指定の VCI インスタンスに対して送信します。

Parameters:
  • messageName (string) -- メッセージの名前

  • value (nil|boolean|number|string|table) -- メッセージの値

  • targetId (string) -- 送信先に指定する VCI インスタンスの ID

説明#

送信先クライアント

送信先 VCI インスタンス

自分自身を含むすべて

指定 ID の VCI インスタンス

  • targetId に指定した ID の VCI インスタンスに対して送信します。

  • 自分自身を含むすべてのクライアントに対して送信します。

  • 同じ VCI が複数インスタンス存在しても、自分自身の VCI インスタンスにのみメッセージを届けることができます。

    • 自分自身の VCI インスタンスにのみメッセージを送りたい場合は、 ExportMessage.EmitToSelf() を使用すると簡潔に記述できます。

  • なるべく update()updateAll() などのイベントで周期的に呼び出さないでください

Example#

function onUse(objectName)
    -- 自分自身の VCI インスタンスに対してメッセージを送信
    vci.message.EmitWithId("color", 3, vci.assets.GetInstanceId())
end