vMixCUE v260918_02
無題
未接続 — 接続しなくてもコマンド生成は使えます
設定 / リセット

アプリの更新

ファイルに残すもの / ここに残るもの

作ったスクリプト・盤面・テロップの設定は、画面いちばん上の「保存」で ファイル(.vcue)にします。「新規」で空にして、「開く」で戻せます。

いっぽう接続先・お気に入り・設定のプリセット・リファレンス・StreamDeck のテンプレートは、 現場が変わっても持ち越すものなのでファイルには入れません。「新規」にしても消えません。 ここで初期に戻せます。

プリセット(このアプリの中に保存)

ファイルにしないで、いまの状態をこのアプリの中に取っておきます。 現場ごとに切り替えたいときに。

呼び出すと、いまの状態は置き換わります。呼び出したあと画面を読み込み直します。

リセット

元に戻したいものにチェックを入れて押してください。リセットしたものは元に戻せません。
作ったものを空にしたいだけなら、上の「新規」を使ってください。

リセットしたあと、画面を読み込み直します。
テンプレートの作り方

Stream Deck のプロファイルの中身は、Elgato が公開していません。 想像で組み立てると読み込めないファイルになるので、 本物を1つ作っていただき、その中のボタンを複製するやり方にしています。 最初の1回だけの作業です。

1. 新しいプロファイルを作る

  1. Stream Deck アプリの左上、機種名(Stream Deck XL など)の下にある プロファイル名をクリックして、新規作成します (右上の歯車 → プロファイルからでも作れます)
  2. 名前は何でも構いません

2. 「Webサイト」を1個だけ置く

右の一覧の システム の中にある Webサイト を、 いちばん左上のマスにドラッグします。

3. 下の設定を3つ入れる

タイトル 
URL 
URL の下のドロップダウン背景でGETリクエストを実行 を選ぶ

3つめは、はじめ「デフォルトのブラウザ」になっています。 ここを変えないと、押すたびにブラウザが開いてしまいます。
タイトルと URL の2つは目印です。書き出したファイルの中からこの文字を探して、 vMixCUE の名前と URL に入れ替えます。一字一句そのまま入れてください。

4. 書き出して読み込ませる

  1. いま作ったプロファイルを右クリック → 書き出し (左上のプロファイル名からでも、歯車 → プロファイル からでも構いません)
  2. この画面の 「自分のテンプレートを使う」 で、そのファイルを選ぶ

安全のために:vMixCUE は Stream Deck の設定フォルダを触りません。 いまあるプロファイルを書き換えることもありません。新しいファイルを作るだけです。 書き出すときに vMix へコマンドを送ることもありません。

使い方

1vMixCUE でできること

vMix に送るコマンドを作って、ボタンに並べて、本番で押すためのアプリです。 タブは仕込み → 本番の順に並んでいます。 vMix につないでいなくても、コマンドを作るところまでは全部使えます。

仕込み(本番前に作る) Cue Generator Script Builder StreamDeck Transfer Setup Checker 流し込む 本番(当日に使う) Control Board Title Editor State Monitor vMix 別PCでもOK タブの下の1行に、その画面の説明が出ます

2ファイル(新規 / 開く / 保存)

作ったものは画面いちばん上の「保存」でファイル(.vcue)にできます。 現場ごとにファイルを分けておけば、「開く」で丸ごと戻せます。

ファイルに入るのはその回の作りものです。 Script Builder のスクリプト、Control Board の盤面、StreamDeck の盤面、 Title Editor の設定、Setup Checker の記録。
いっぽう接続先・お気に入り・設定のプリセット・リファレンス・StreamDeck のテンプレートは、 現場が変わっても持ち越すものなのでファイルには入りません。 「新規」にしても消えません。

新規作ったものを空にして、はじめから作り直す
開く保存したファイル(.vcue)を読み込む
保存いまの内容をファイルに書き出す(⌘/Ctrl + S)

名前の右に * が付いているときは、まだ保存していない変更があります。 そのまま閉じようとすると引き止めます。

3Cue Generator — 1コマンドを作る

左の一覧から関数を選び、Input や Value の欄を埋めて、下のタブで形式を選んでコピーします。 vMix につないでいれば、「vMix に送信」でその場で試せます。 ★を押してお気に入りに入れると、次からは一覧の先頭に出ます。

SetText 関数 792 個から選ぶ Input Value 欄を埋める GET http://…/api/?… コピー / vMix に送信
  • Input の書き方は GUID / 名前 / 番号。既定は GUID(並べ替えても変わらず、いちばん壊れにくい)
  • 特殊値 … None(指定しない)/ Program(0)/ Preview(-1)/ Dynamic 1〜4。 Dynamic は SetDynamicInput1 で中身を入れておく「差し替え式の置き場」です

4Script Builder — 手順を1本にまとめる

コマンドを上から順に実行するリストにします。「次まで待つ」で待機(ミリ秒)を挟めます。 行はドラッグで並べ替え、名前を付けてプリセット保存できます。

1. OverlayInput1In 2. 待つ 1000ms 3. OverlayInput1Out 上から順に実行される Web スクリプトなどにコピー ボタン1個として送る(下記)

リスト全体を + StreamDeck Transfer へ(マルチアクションになる)、 + Control Board へ(1ボタンになる)で流し込めます。

5StreamDeck Transfer — 実機のボタンにする

送ったコマンドを実機と同じマス目に並べ、名前・色・文字を整えて .streamDeckProfile に書き出します。書き出したファイルをダブルクリックするだけで Stream Deck に読み込まれます。そちら側での準備はいりません。

CAM1 CAM2 プロファイル.stream…ダブルクリックで登録 実機
Shift + クリックそのマスを vMix に送って試す(書き出す前の確認)
⌘/Ctrl + クリック複数選択。まとめて移動・色替え
Alt(option) + ドラッグ複製
⌘/Ctrl + C / X / V / D / Aコピー / 切り取り / 貼り付け / 複製 / 全選択
Deleteマスを空にする

6Setup Checker — 本番前の見落とし探し

「▶ チェックする」を押すと、いまの vMix を一通り見て、 事故になりそうなところを挙げます。重さは3段階です。 重大は本番で事故になるもの、注意は意図的ならそのままで構わないもの、 確認は vMix の API からは判断できないので人が見るものです。
差分ウォッチは、仕込みが終わった時点を記録しておく機能です。 本番前にもう一度チェックすると、そこから変わったところだけが出ます。

重大 … プリセットを保存していない 注意 … 入力がミュートのまま 問題なし … 12 件 差分ウォッチ 仕込み完了 → 記録しておく 本番前にもう一度 → 変わった所だけ出る

6.5素材の再リンク(Setup Checker の中)

別の PC に移すと、素材のパスが合わなくなって真っ黒になります。 vMix のプリセット(.vmix)を開いて、中のパスをまとめて付け替えます。

入力の Key もショートカットもそのまま残ります。 vMix には「入力のファイルだけ差し替える」命令が無いので、 入力を作り直すと指し先が壊れます。プリセットのパスだけを書き換えるのが確実です。

.vmix を開くパスを全部拾う 当てる名前で探す 別名で書き出す元は残ります

素材があちこちに散らばっていても、1本ずつ教えれば芋づるで直ります。 見つからない行の「場所を探す…」で場所を教えると、 同じ場所にある残りもまとめてつながります。 探した場所はためていくので、1か所ずつ教えるだけで数が増えていきます (Premiere の再接続と同じ考え方です)。

開くと、いま vMix が開いているものを自動で持ってきます。 直したら「vMix に戻す」で読み込ませられます(同じ PC のときだけ)。 別の PC のときは「.vmix を開く…」でファイルから読み、 「別名で書き出す」で保存してください。

名前が違うファイルにも付け替えられます。 行の「別のファイル…」で、その場で選べます。 一度選んだものは、探し直しても消えません。

録画の保存先と、vMix 付属のファイル(Program Files 配下)は触りません。 元のプリセットも上書きしません。

7Control Board — 押して送る操作盤

ボタン・ラベル・テキスト・タイマー・得点の5種類の部品を自由に並べられます。

大事なのは右上の切り替えです。編集モードのあいだは、部品を押しても送信しません。 本番モード(赤)のときだけ vMix にコマンドが飛びます。 ボタンの枠は、本線に出ていれば 赤、 プレビューなら 緑 に光ります(vMix を見て自動で変わります)。

CAM 1 CAM 2 テロップ 赤=本線に出ている 緑=プレビュー 編集モード … 触っても安全 本番モード … 押すと送信

並べ替えの操作は StreamDeck Transfer と同じです。 それに加えて、空いている場所からドラッグして囲むと、触れた部品をまとめて選べます。 ページを分ければ、盤面は何枚でも持てます。

8Title Editor — テロップの中身を書き換える

vMix のタイトル(GT)を読み込んで、文字を書き換えてその場で送出します。 オーバーレイ 1〜4 の出し入れ、スコアボードの加減点、カウントダウンも、 ここから操作できます。

よく使う中身はプリセットとして名前を付けて保存できます。 呼び出しても vMix には送りません(画面に入るだけです)。誤って出さないためです。

9State Monitor — 横目で見る画面

本番中に横目で見るための画面です。押して何かを変えるものは置いていません。

プレビューと本線を大きく出して、その下にオーバーレイ (赤が本線 / 緑がプレビュー)、 録画・配信の状態、音声、再生中の動画の残り時間を並べています。

List の走順も出ます。再生中の List と、PGM / PVW に乗っている List について、 いま出ている素材(▶)と次に来る素材(「次」の印)、 1本ずつの尺、走順ぜんぶの尺を並べます。 尺は List Deck の「尺を確認」で読んだものを使うので、 まだ読んでいないものは --:--、静止画は尺を持たないので — です。 ここでは触れません(並べ替えは List Deck、出し入れは vMix 本体か Control Board)。

PVW次に出すもの PGMいま出ているもの OP動画 残り 0:42 残り時間は毎秒動きます

10List Deck — List の中身を整える

vMix の List 入力が、そのまま1枚のカードになります。映像だけでなく 静止画も音声も入ります。見て、並べ替えるための画面です。

再生や頭出しはここでは行いません。vMix 本体か、Control Board に作った ボタンから送ってください。本番中にこの画面から出し戻しできると事故のもとになるためです。

リストの名前 Input 5 PVW いま載っている素材の名前 0:21 / 1:30 1 オープニング.mp4 映像 2 スポンサー.png 静止画

できること

  • 名前を出す・変える(vMix 側の入力名も変わります)
  • いま載っている素材の名前と、再生の進行バー
  • 走順の並べ替え(行をドラッグ)と、素材の複製 + / 削除 ×
  • リストごと複製(vMix に同じ中身の List をもう1つ作ります)
  • ループ(最後まで行ったら先頭へ戻る)
  • 尺を確認 … 1本ずつ選んで長さを読み、元の位置に戻します。 走順ぜんぶの尺(見出しの右)と、State Monitor の全体の残り時間に使われます
  • カードの右下をつまむと大きさを変えられます

本線に出ている(赤い枠の)リストは、走順を触れません。 vMix には並べ替えの命令が無く、送るには「全部消して入れ直す」しかないためです。 その一瞬 List が空になり、出力が黒くなります。降ろしてから並べ替えてください。

11vMix につなぐ

上のバーに vMix の IP とポートを入れて「接続 / 更新」。 つながると Input の一覧が自動で入り、タリーや State Monitor が動き出します。

vMixCUE このPC(Mac / Win) http://192.168.○.○:8088 vMix の PC 設定 → Web Controller を有効に
  • 同じ PC の vMix … IP は 127.0.0.1(自分自身を指す番号)
  • 別の PC の vMix … その vMix の Settings → Web Controller に出ている IP を入れる
  • ポート … ふつうは 8088 のまま。変えたときは「↺ リセット」で 127.0.0.1 / 8088 に戻せます

12つながらないとき(CORS)

vMix は「よそのページから直接読まれるのを断る」作りのため(CORS という決まり)、 HTML 版をブラウザで開いた場合だけ、Input 一覧が読めないことがあります。 コマンド作りは全部使えるので、Input は名前や番号を直接入力してください。

HTML 版(ブラウザ) ブラウザ ブラウザの決まりで断られることがある vMix Web Controller アプリ版(Windows / macOS) 画面 同梱サーバー アプリの中のサーバーが中継=制限なし

確実につなぎたいときは Windows 版 / macOS 版を使ってください。 それでもつながらないときは、vMix の 設定 → Web Controller が有効か、 IP とポートが合っているか、同じネットワークにいるかを確かめます。

サイトで開く Web 版も HTML 版と同じで、vMix の状態は読めません (Title Editor・Setup Checker・List Deck・State Monitor は使えません)。 コマンドを送ることはできます。Chrome / Edge では、はじめて送るときに 「ローカルネットワーク上のデバイスへのアクセス」を聞かれるので、許可してください。 一度開いたあとは、ネットに繋がっていない現場でも開けます。

13出力形式(5種類)

HTTP GETブラウザ・Stream Deck の「Website」・curl などから叩く URL
TCP APIポート 8099 の TCP 接続で送る形式
CompanionBitfocus Companion の「Scripting - Run custom command」に貼る
Web スクリプトWeb Controller のスクリプト欄。1行1コマンド、Sleep 1000 で待機
VB.NET スクリプトvMix の 設定 → Scripting に貼る

14リファレンスの更新(vMix 30 が出たら)

  1. Windows 版 / macOS 版で開く(HTML 版では使えません)。ネット接続も必要
  2. 画面いちばん下の右にある数字を 29 → 30 に変える
  3. 「リファレンスを更新」を押す → 「更新しました(◯◯関数)」で完了

日本語解説は関数名が同じものは引き継がれ、増えた関数だけ英語のまま出ます。 内蔵の v29 に戻すには

フォルダを選ぶ
素材の再リンク
素材を探す場所