SendMessage#

ExportOsc.SendMessage(address, arguments)#

ExportOscType で指定された型の OSC Argument を任意の個数含む OSC Message を送信します。

Parameters:
  • address (string) -- OSC Message の送信先の OSC Address

  • arguments (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")