コンテンツにスキップ

プラグイン系APIについて

内容について

この内容はサービス改良の中で予告なく改定されることがあります

翻訳・発話サーバ

  • ゆかりねっとコネクターNEOを通して翻訳と読み上げをサポートします。

使用条件

  • 翻訳/発話連携サーバプラグインをONにしていること
  • 翻訳1の翻訳エンジンを選定していること(これが使われます)
  • 送信先ポートはレジストリから取得します

翻訳(1言語)

  • 翻訳/発話連携サーバプラグインが開いているHTTPサーバもしくはWebSocketサーバに下記のリクエストを送付してください。
  • 送付方式:HTTPの場合はPOST、WSの場合はテキスト
{
    operation: 'translate',
    params: [
        {
            id: '0000-0000-0000-0000',
            lang: 'en_US',
            text: 'こんにちは'
        }
    ]
}
{
    operation: 'translate',
    status: 'success'
    id: '0000-0000-0000-0000',
    lang: 'ja_JP',
    text: 'Hello.' 
}
{
    operation: 'translate',
    status: 'failure'
    id: '0000-0000-0000-0000',
    lang: 'ja_JP',
    text: 'こんにちは.' 
}
  • 要求時は、翻訳してほしい言語を指定します。
  • 返答時には、推定した言語と翻訳した文が来ます。
  • statusがfailureの場合は、処理に失敗しています。

翻訳(複数言語)

対応プラグインバージョン: v1.4以上

  • 翻訳/発話連携サーバプラグインが開いているHTTPサーバもしくはWebSocketサーバに下記のリクエストを送付してください。
  • 送付方式:HTTPの場合はPOST、WSの場合はテキスト
{
    operation: 'translates',
    params: [
        {
            id: '0000-0000-0000-0000',
            lang: [
                'ja_JP',
                'en_US',
                'fr_FR'
            ],
            text: 'こんにちは'
        }
    ]
}
{
    operation: 'translates',
    status: 'success'
    id: '0000-0000-0000-0000',
    detect_language : 'ja_JP',
    result : [
        {
            lang: 'ja_JP',
            text: 'こんにちは' 
        },
        {
            lang: 'en_US',
            text: 'Hello.' 
        },
        {
            lang: 'fr_FR',
            text: 'bonjour.' 
        }
    ]
}
{
    operation: 'translates',
    status: 'success'
    id: '0000-0000-0000-0000',
    detect_language : 'unknown',
    result : [
        {
            lang: 'ja_JP',
            text: 'こんにちは' 
        },
        {
            lang: 'en_US',
            text: 'Hello.' 
        },
        {
            lang: 'fr_FR',
            text: 'bonjour.' 
        }
    ]
}
{
    operation: 'translates',
    status: 'failure'
    id: '0000-0000-0000-0000',
    message: '翻訳サーバに接続できません'
}
  • 要求時は、翻訳してほしい言語を指定します。
  • 返答時には、推定した言語と翻訳した文が来ます。
  • statusがfailureの場合は、処理に失敗しています。

読み上げ

  • 翻訳/発話連携サーバプラグインが開いているHTTPサーバもしくはWebSocketサーバに下記のリクエストを送付してください。
  • 送付方式:HTTPの場合はPOST、WSの場合はテキスト
{
    operation: 'speech',
    params: [
        {
            id: '0000-0000-0000-0000',
            text: 'こんにちは',
            talker: 'ずんだもん/VOICEVOX'
        }
    ]
}
{
    operation: 'speech',
    status: 'sended'
    id: '0000-0000-0000-0000',
    text: 'こんにちは.' 
}
{
    operation: 'speech',
    status: 'failure'
    id: '0000-0000-0000-0000',
    text: 'こんにちは.' 
}
  • 要求時は、発話してほしいボイスキャラクターを指定するとその音源で話そうとします。
  • statusがfailureの場合は、プラグインが無効な場合など要求が出せなかった場合にでます。
  • statusがsendedの場合、要求自体はだせたという意味で、発話が完了したわけではありません。

音声話者リスト

  • 送付方式:HTTPの場合はPOST、WSの場合はテキスト
{
    operation: 'speech.getvoicelist',
    params: [
        {
            id: '0000-0000-0000-0000',
        }
    ]
}
{
    operation: 'speech.getvoicelist',
    status: 'sended'
    id: '0000-0000-0000-0000',
    voice: [
            'ずんだもん/VOICEVOX',
            '弦巻マキ(日)/CeVIO AI'
        ]
    }
}
{
    operation: 'speech.getvoicelist',
    status: 'failure'
    id: '0000-0000-0000-0000'
}

発話の強制停止

  • 送付方式:HTTPの場合はPOST、WSの場合はテキスト
  • キューをクリアするため、現在発話動作に入っているものは読み上げします。
{
    operation: 'speech.stop',
    params: [
        {
            id: '0000-0000-0000-0000',
        }
    ]
}
{
    operation: 'speech.stop',
    status: 'sended'
    id: '0000-0000-0000-0000',
}
{
    operation: 'speech.stop',
    status: 'failure'
    id: '0000-0000-0000-0000'
}

バージョンの取得

対応プラグインバージョン: v1.4a以上

  • 送付方式:HTTPの場合はPOST、WSの場合はテキスト
{
    operation: 'version',
    params: [
        {
            id: '0000-0000-0000-0000',
        }
    ]
}
{
    operation: 'version',
    status: 'success',
    version: [
        {
            System: '1.959',
            Plugin: '1.4a'
        }
    ]
    id: '0000-0000-0000-0000',
}
{
    operation: 'version',
    status: 'failure',
    id: '0000-0000-0000-0000'
}
名前 意味
System String NEO本体のバージョン
Plugin String 翻訳/発話連携サーバプラグイン

入力支援

  • ゆかりねっとコネクターNEOの文字入力を支援します

使用条件

  • 入力支援プラグインをONにしていること
  • 送信先ポートはレジストリから取得します

遠隔操作

  • 送付方式:HTTP(GET)
    http://localhost:15520/api/command?target=Plugin_InputAssist&command=prev
    http://localhost:15520/api/command?target=Plugin_InputAssist&command=next
    http://localhost:15520/api/command?target=Plugin_InputAssist&command=send
    http://localhost:15520/api/command?target=Plugin_InputAssist&command=sendnext

歌詞プラグイン

  • ゆかりねっとコネクターNEOの文字入力を支援します

使用条件

  • 入力支援プラグインをONにしていること
  • 送信先ポートはレジストリから取得します

遠隔操作

  • 送付方式:HTTP(GET)
    http://localhost:15520/api/command?target=Plugin_LyricAssist&command=play
    http://localhost:15520/api/command?target=Plugin_LyricAssist&command=pause
    http://localhost:15520/api/command?target=Plugin_LyricAssist&command=stop
  • sukiyuki.stl を読み込む場合
        http://localhost:15520/api/command?target=Plugin_LyricAssist&command=load&file=d:/sukiyuki.stl
    

OSCプラグイン

  • 指定したOSCメッセージを送付します。

使用条件

  • OSCプラグインをONにしていること
  • 送信先ポートはレジストリから取得します
  • OSCプラグイン v1.5以上で有効

OSCメッセージの遠隔発火

  • 送付方式:HTTP(GET)
  • 送信タグ名 EyeClose を送りたい場合
        http://localhost:15520/api/command?target=Plugin_VRChat_OSC&command=exec&tag=EyeClose
    

HTTPコールプラグイン

  • 指定したHTTP呼び出し(GET)を送付します。

使用条件

  • HTTPプラグインをONにしていること
  • 送信先ポートはレジストリから取得します
  • ゆかりねっとコネクターNEO v2.0~で有効

HTTPメッセージの遠隔発火

  • 送付方式:HTTP(GET)
  • 送信タグ名 CALL を送りたい場合
        http://localhost:15520/api/command?target=Plugin_HTTPCall&command=exec&tag=CALL
    

clusterウェブトリガープラグイン

  • 指定したHTTP呼び出し(GET)を送付します。

使用条件

  • clusterウェブトリガープラグインをONにしていること
  • 送信先ポートはレジストリから取得します
  • ゆかりねっとコネクターNEO v2.0~で有効

ウェブトリガーの遠隔発火

  • 送付方式:HTTP(GET)
  • 送信タグ名 Trig1 を発火したい場合
        http://localhost:15520/api/command?target=Plugin_ClusterTrigger&command=exec&tag=Trig1
    

共通項目

通信ポートの特定

  • 通信ポートはレジストリから取得できます

使用条件

  • ポートを開放したときに更新されます
  • レジストリ位置:HKCU\Software\YukarinetteConnectorNeo\TransServer
名前 意味
WebSocket DWord32 WebSocketポート番号
HTTP DWord32 HTTPポート番号

最終更新日: September 26, 2022