Persona

LAPLACE Persona公式のElgato Stream Deckプラグインは、プラグインAPIを物理キーに割り当て、モデルの切り替え、シーンの適用、シーンプリセットの適用、ショートカットやオートメーションの実行、表情やモーションの切り替え、動的テキストの設定、ステージ上でのアバターの移動・スケーリングをワンタッチで操作できるようにします。

このプラグインはWebコンソールと同じAPIを利用しています。デスクトップアプリでAPIを有効にしてAPIキーを作成するだけで接続できます。

前提条件アンカーリンクをコピー

インストールアンカーリンクをコピー

上のインストールボタンをクリックすると、Stream Deckアプリ経由でインストールされます。Stream Deck内蔵のMarketplaceで「LAPLACE Persona」を検索してインストールすることもできます。インストールが終わると、Stream Deckのアクション一覧にLAPLACE Personaカテゴリが追加されます。

接続設定アンカーリンクをコピー

任意のアクションをキーにドラッグ＆ドロップすると、右側のプロパティインスペクター下部に接続設定フィールドが表示されます。

この2つの設定はすべてのアクションで共有されるため、どれか1つのアクションで入力すれば全体に反映されます。

接続されると、Personaの接続中のクライアント一覧にElgato Stream Deck（開発者：LAPLACE）が表示されます。

アクション一覧アンカーリンクをコピー

Activate Scene、Apply Preset、Run Automation、および対象テキストレイヤーを指定するSet Text以外のアクションは、現在のシーンのメインモデルを対象とします。Trigger Hotkeyは、選択したショートカットが属するモデルに対して実行されます。

モデル、シーン、プリセット、ショートカット、オートメーション、表情、モーションの各ドロップダウン項目は、起動中のPersonaからリアルタイムに取得されます（プリセット一覧は現在のシーンから取得）。プロパティインスペクターを開いている間、オートメーション一覧は変更に合わせて自動で更新され、一時停止中の項目はグレー表示になります。未接続のときは空欄ではなく、接続状態を示すメッセージが表示されます。

移動とスケーリングアンカーリンクをコピー

移動とスケーリングのアクションでは、1回あたりの変化量をカスタマイズできます。キーを長押しすると約300ミリ秒後に連続実行が始まり、その後は100ミリ秒ごとに繰り返されます。途中でエラーが発生した場合はすぐに止まり、キーに警告アイコンが表示されます。

2Dと3Dのステップ値はそれぞれLive2Dのスクリーンピクセル空間とVRMのワールド空間に対応しているため、1つのキーでどちらのモデル形式もそのまま操作できます。スケーリング範囲はアプリ側の安全上限・下限に収まるため、長押ししても極端に拡大・縮小されることはありません。Factorが1未満の場合は、方向の指定に関わらずその倍率で縮小されます。

キー表示とフィードバックアンカーリンクをコピー

キーのアイコンにはPersonaのロゴと各アクションのアイコンが組み合わされて表示され、アクション名はStream Deckアプリの言語設定に従います。カスタムタイトルを設定するとアイコンの上に重ねて表示され、カスタム画像を設定するとデフォルトのアイコン全体が置き換わります。

アクションが成功すると一時的にチェックマークが表示され、失敗すると警告アイコンが表示されてプラグインログにエラーが記録されます。長押しによる連続実行中は、画面のちらつきを抑えるためチェックマークを表示しません。