SendMessage#
- ExportOsc.SendMessage(address, arguments)#
ExportOscType
で指定された型の OSC Argument を任意の個数含む OSC Message を送信します。- Parameters:
address (
string
) -- OSC Message の送信先の OSC Addressarguments (
table
) -- 送信する OSC Argument の型(ExportOscType
)と値を列挙したテーブル
- ExportOsc.SendMessage(address)
OSC Argument を含まない OSC Message を送信します。
- Parameters:
address (
string
) -- OSC Message の送信先の OSC Address
説明#
address
に指定された OSC Address に、 arguments
に指定された OSC Argument を OSC Message として送信します。
引数を含まない OSC Message を送信する場合は、ExportOsc.SendMessage(address)
を使用してください。
送信される OSC Message に付随する OSC Type Tag String は、 ,
から始まり、 OSC Argument の型を順に並べたものとなります。
address
が nil、または OSC Address として不正なフォーマットの場合、送信に失敗します。この時、エラーメッセージがコンソールに出力されます。
arguments
テーブルは、以下のフォーマットで記述します。
-- {
-- {(OSC Argument 1 の型を表す ExportOscType), (OSC Argument 1 の値)},
-- {(OSC Argument 2 の型を表す ExportOscType), (OSC Argument 2 の値)},
-- {(OSC Argument 3 の型を表す ExportOscType), (OSC Argument 3 の値)},
-- ...
-- }
-- 例: String, Int32, Float32, BlobAsUtf8 を OSC Argument として送信したい場合
arguments = {
{ExportOscType.String, "hello"},
{ExportOscType.Int32, 123},
{ExportOscType.Float32, 1.23},
{ExportOscType.BlobAsUtf8, "こんにちは"},
}
Example#
-- /test/sendmultiple ,sifb "hello" 123 1.23 "こんにちわ" という OSC Message を送信
vci.osc.SendMessage("/test/sendmultiple", {
{ExportOscType.String, "hello"},
{ExportOscType.Int32, 123},
{ExportOscType.Float32, 1.23},
{ExportOscType.BlobAsUtf8, "こんにちは"},
})
-- /test/sendnone という OSC Message を送信
vci.osc.SendMessage("/test/sendnone")