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 インスタンスに対して送信します。ID は
ExportAssets.GetInstanceId()
で取得できます。
自分自身を含むすべてのクライアントに対して送信します。
同じ VCI が複数インスタンス存在しても、自分自身の VCI インスタンスにのみメッセージを届けることができます。
自分自身の VCI インスタンスにのみメッセージを送りたい場合は、
ExportMessage.EmitToSelf()
を使用すると簡潔に記述できます。
なるべく
update()
やupdateAll()
などのイベントで周期的に呼び出さないでください。
Example#
function onUse(objectName)
-- 自分自身の VCI インスタンスに対してメッセージを送信
vci.message.EmitWithId("color", 3, vci.assets.GetInstanceId())
end