Persona公式のElgato Stream Deckプラグインは、プラグインAPIをStream Deckのキーから操作できるようにします。モデルの切り替え、シーンの適用、ホットキーとオートメーションの実行、表情の切り替え、モーションの再生、そしてステージ上でのアバターの移動とスケールができます
Webコンソールと同じAPIを使うので、デスクトップアプリ側に特別な準備は要りません——APIをオンにしてキーを1つ作れば、それで設定は完了です
前提条件
| 必要なもの | 説明 |
|---|---|
| Stream Deck | 7.1以降。macOS 12+またはWindows 10+ |
| LAPLACE Persona | 起動中で、プラグインAPIが有効になっていること |
| APIキー | 設定 → プラグインAPIで1つ作成する |
インストール
ページでインストールを押すと、あとはStream Deckアプリが引き受けます。Stream Deckアプリ内蔵のMarketplaceでLAPLACE Personaを検索しても同じです。インストールすると、Stream Deckアプリのアクション一覧にLAPLACE Personaのカテゴリが現れます
接続
任意のアクションをキーに置くと、右のプロパティインスペクターの下部に2つのフィールドが表示されます：
| フィールド | 入力する内容 |
|---|---|
| Persona Address | 空欄なら127.0.0.1:25034。ホスト、ホスト:ポート、あるいは完全なws:// URLも受け付ける |
| API Key | Personaで作成したキーのトークン |
この2つはグローバルです——どれか1つのアクションで入力すれば、すべてのアクションが接続されます
接続すると、Personaの接続中のクライアントに、開発元LAPLACEのElgato Stream Deckという行が現れます
別のマシンのPersonaを操作するには、そちら側でローカルネットワークからのアクセスを許可をオンにし、アドレスにそのホスト:ポートを指定します。接続は平文のws://です——Persona自身はTLSを終端しません——ので、信頼できないネットワークでは前段にTLSプロキシを置き、そのプロキシの完全なwss://
URLをアドレスに貼り付けてください
アクション
シーンを適用とオートメーションを実行を除くすべてのアクションは、現在のシーンのメインモデルを対象にします
| アクション | 効果 |
|---|---|
| モデルを切り替え | メインのアバターを選んだモデルに差し替える。シーンにモデルが1つもない場合は代わりに追加する |
| シーンを適用 | 保存済みのシーンのいずれかを適用する |
| ホットキーを実行 | 現在のモデルのショートカットを1つ実行する。VTube Studioと同様、ホットキーはモデルに属する |
| オートメーションを実行 | オートメーションを1つ実行する——キーの組み合わせが未割り当てでもアクション一式が走る |
| 表情を切り替え | 現在のモデルの表情を1つ切り替える |
| モーションを再生 | 現在のモデルのモーションを1つ再生する。そのモーションの再生中にもう一度押すと停止する |
| モデルを移動 | アバターを一方向に少し動かす。押し続けると動き続ける |
| モデルをスケール | アバターを拡大または縮小する。押し続けるとスケールし続ける |
| トランスフォームをリセット | アバターの位置・スケール・回転を元に戻す |
モデル、シーン、ホットキー、オートメーション、表情、モーションの各ドロップダウンは、動作中のPersonaからその場で取得して埋められます。オートメーションの一覧はプロパティインスペクターを開いている間も編集に合わせて更新され、一時停止中のオートメーションはグレー表示になります。何も接続されていないときは、空欄ではなく理由を説明する1行が表示されます
オートメーションを実行は、複数のステージ操作を1つのキーにまとめられます。Persona側でオートメーションを組み、キーの組み合わせは割り当てないまま、あとはStream Deckに任せてください
移動とスケール
どちらのアクションにも専用のステップがあります。キーを押し続けるとおよそ3分の1秒後に自動リピートが始まり、その後は100 msごとに1ステップ進みます。途中で失敗するとホールドが終了し、キーの警告表示が点滅します
| アクション | 設定 |
|---|---|
| モデルを移動 | 方向（上・下・左・右）、2D Step（ピクセル）、3D Step（ワールド単位） |
| モデルをスケール | 方向（拡大・縮小）とFactor（既定は1.1） |
2つのステップはLive2Dのスクリーン空間とVRMのワールド空間をそれぞれカバーするので、1つのキーがどちらの形式にも合います。スケールはパネル自体の範囲に制限されるため、キーを押し続けてもスケールの上限・下限を超えることはありません。1未満のFactorは、方向の設定にかかわらず常にその比率で縮小します
キー
キーの絵柄はPersonaのマークとそのアクションのアイコンで、アクション名はStream Deckアプリが動作している言語で表示されます。タイトルを設定するとその上に描かれ、カスタム画像を指定すると絵柄が丸ごと置き換わります
アクションが成功するとチェックマークが、失敗すると警告アイコンが点滅し、プラグインのログに1行記録されます。押し続けている間はチェックマークを出さないので、1ステップごとに点滅することはありません
プラグインが同梱しているのは英語と簡体字中国語で、Stream Deckアプリの言語設定に従います。プロパティインスペクターのフィールド名は、いまのところ英語のみです
最終更新日：2026年9月19日