Language:

サイドバー

バーチャルキャスト公式Wiki

メインメニュー

初心者向けガイド

VirtualCast

遊ぶ世界

THE SEED ONLINE

ニコニコ

SHOWROOM

配信

配信ツール

その他

wikiについて

デベロッパー向け


開発環境

VRM(アバター)

VCI(アイテム/背景)

VCI更新情報

更新日 - UniVCI バージョン
2021/03/17 v0.32
2.0.3b
2021/01/14 v0.31
2.0.1a
2020/12/03 v0.30
2.0.0b
2020/11/12 v0.30
2.0.0a
2020/10/22 v0.29
1.9.5b
2020/07/30 v0.29
1.9.3e
2020/06/25 v0.28
1.9.3c
2020/05/21 v0.27
1.9.2e

以前のアップデート履歴


GLB(背景)

vci:script:reference:message

vci.message(VCI間の通信)

VCIから別のVCIへMessageを飛ばしてVCI間の通信に使用する事が出来ます。
この機能により、VCIからVCIに対して操作する事が可能となります。
共有変数とは扱いが異なります。

vci.message で送信出来る文字量は UTF-8 換算で 4000 byte までとなります。

バーチャルキャスト1.5.4aのVCI更新

  • メッセージはメッセージ送信時に居たプレイヤー間でしか処理されません。
  • (あとから入室してもsetで情報を共有できる共有変数とは異なります)
  • 今後のアップデートでシステムからのメッセージを受け取る事を予定しています。

関数一覧

名前 説明 対応バージョン
Emit(messageName, value) メッセージを送信します。メッセージは、自分自身を含む全ユーザーの全VCIに送信されます。
EmitWithId(messageName, value, targetId) 特定のVciIdを指定することで、指定のVCIに対してメッセージを送信することが出来ます v2.0.0b以降
On(messageName, callback) メッセージを受信します。

Emit(messageName, value)

  • メッセージを送信します。
  • メッセージは、自分自身を含む全ユーザーの全VCIに送信されます。

EmitWithId(messageName, value, targetId)

  • 特定のVciIdを指定してメッセージを送信します。

On(messageName, callback)

  • メッセージを受信します。
  • メッセージを送信したのと同じVCIでも、別のVCIでもOK。
  • Onの第1引数と Emitの第1引数 が一致したものを受け取ります。
  • 受け取ったメッセージを第2引数の関数に渡します。
  • Onは第2引数で指定した関数よりも後に定義してください。受信関数よりも前に定義するとエラーとなります。

callback(sender, name, message)

以下、3つの引数をとります。senderはシステムによって設定される送信者情報のtableです。

引数 内容
sender.type vci という文字列。
sender.name 送信元のVCIのTitle。
sender.commentSource 空文字列。
name メッセージの名前。Emit 関数の第1引数です。
message メッセージの内容。Emit 関数の第2引数です。

具体例

送信側

send.lua
function onUse(self)
    -- 第1引数にメッセージの種類 第2引数にメッセージの内容
    -- 今回は受信側のSubItemをジャンプさせるメッセージとその強さを指定
    vci.message.Emit("message_jump",3000)
end

受信側

get.lua
local receiver = vci.assets.GetTransform("Cube")
 
    -- sender: 送信者情報(システムが設定します)
    -- name: メッセージの名前。Emit 関数の第1引数です。
    -- message: メッセージの内容。Emit 関数の第2引数です。
function Jump(sender, name, message)
 
    for k, v in pairs(sender) do
        print(k .. ":" .. v)
    end
 
    -- nameにメッセージの種類 messageにメッセージの内容が入ってます    
    print(name)
    print(message)
 
    --messageに入っているジャンプの強さでSubItemを飛ばします
    receiver.AddForce(message*receiver.GetUp())
 
end
 
--シーンでメッセージ名が"message_jump"のvci.message.Emitが実行されたときにJump関数が呼び出される
vci.message.On("message_jump", Jump)

EmitWithIdで特定のVCIに対して送信する

get.lua
function GetMessage(sender, name, message)
    print(message.abc)
end
 
vci.message.On("123", GetMessage)
function update()
    -- vci.assets.GetInstanceIdを指定して自分自身にだけ送信する
    vci.message.EmitWithId("123", { abc = "ハロー" }, vci.assets.GetInstanceId())
end 

送信側がやっている事
基本的に送りたいメッセージをEmit()を実行して送るだけです。
ただし、受信側とどのようなメッセージをやり取りするかは事前に決めておく必要があります。

受信側がやっている事
1.vci.message.On() で受信したいメッセージの種類を登録します。
 Emit()でメッセージが送信された時にOn()で登録されたメッセージを読み込むことができます。
2.この例では、送られてきたメッセージはJump()に渡されます。
 メッセージの内容がJump()の引数として与えられます。
3.Jump()の引数の内容がメッセージの内容なので、
 送信するメッセージの内容を変化させることで、受信側の挙動を変えることができます。

サンプル

vci/script/reference/message.txt · 最終更新: 2021/08/03 17:55 by t-daihisa

ページ用ツール