Persona

設定はコントロールパネルの左の列の一番下の行で、どのシーンが有効でも変わらないものがすべて入っています。UIの言語、テーマ、トレイアイコン、音声出力、描画パフォーマンス、そしてプラグインAPIです。アップデートと概要ダイアログはパネルのヘッダーにあります

オートメーションはここではなく、トラッキングのすぐ下にある独立した行です——オートメーションを参照してください

このページは一般・パフォーマンス・保存場所・プラグインAPIの4つの折りたたみセクションに分かれていて、展開・折りたたみの状態はそれぞれ記憶されます。保存場所とプラグインAPIは既定で閉じています

ステージのウィンドウの大きさと、配信モード・インスペクタ・FPSカウンターを表示はここではなく、ステージの行のウィンドウセクションにあります

一般

言語

Personaには4つのUI言語が同梱されており、ピッカーにはそれぞれの言語自身の表記で並びます

システムはOSが報告する言語タグを読みます。中国語は繁体字の変種——zh-Hant、zh-TW、zh-HK、zh-MO——では繁體中文になります。ほとんどのシステムがこれらをHantサブタグなしで報告するため、地域で判定しています。それ以外は简体中文になります。日本語はそのまま日本語です。それ以外はすべてEnglishにフォールバックします

変更は再起動なしで、トレイメニューを含むUI全体に即座に反映されます

テーマ

コントロールパネルとそのダイアログ・メニューの配色です。システム、ライト、ダークから選べます。既定はシステムで、OSの外観に合わせて切り替わります

これが変えるのはUIだけです。ステージは影響を受けません——そこに描かれるものは背景、ライト、エフェクトが決めるもので、UIのテーマには影響されません

パネルを常に最前面に表示

コントロールパネルをステージや他のウィンドウの上に浮かせます。シーンを整えるためにステージをクリックしながら、パネルを見続けられます。既定ではオフです。対象はパネルであって、ステージではありません——ウィンドウの動作を参照してください

メニューバーアイコン

このスイッチはWindowsではトレイアイコンを表示、macOSとLinuxではメニューバーアイコンを表示という名前です。各プラットフォーム自身の呼び方に合わせています

macOSではこのアイコンはモノクロのテンプレート画像なので、ネイティブアプリと同じようにメニューバーに馴染みます——明るいバーでは暗く、暗いバーでは明るく表示されます

オフにするとメニューバーがすっきりし、失われる入り口もありません。スイッチの下には、それなしでコントロールパネルを呼び戻す方法が書かれています：macOSでは ⌘ + , かアプリメニュー、WindowsとLinuxではステージをクリックしてから Ctrl + , です

音声出力デバイス

Personaの音が出る先です。インベントリやオートメーションで再生する音声ファイルと、Live2Dモデルの音——モーションの音声やプラグインAPIで再生する音声——が対象です。システムのデフォルトはシステム自身の出力に従います。特定のデバイスを選ぶこともできます

保存したデバイスが接続されていないと利用できないデバイスと表示され、接続されているデバイスを選ぶまで、音声の再生はデフォルトに切り替わらずにエラーになります

バグレポートを送信

既定でオンです。クラッシュやエラーを送信し、アプリの問題の調査に役立てます。レポートには診断情報と直近のアプリ動作が含まれ、ウェブページレイヤーのURLが記録される場合があります。ネイティブクラッシュのレポートにはメモリダンプが含まれる場合もあります

オフにすると、レポーターはそもそも初期化されません。この設定は起動時に読まれるので、変更すると完全に適用するには再起動が必要ですの案内が出ます

パフォーマンス

バックグラウンド描画

Personaは常にバックグラウンド描画を続けるようになりました。OSは通常、隠れたり背面に回ったりしたウィンドウを制限するので、アバターのアニメーションが止まってしまいます——OBSがウィンドウをキャプチャしていて、別のアプリに切り替えているときには最も避けたい事態です。Personaは描画ループを動かし続け、アプリを一時停止しないようOSに要求します

以前のスイッチはなくなり、設定は不要です。ディスプレイはOSの設定どおりスリープできます

フレームレートを制限

両方の描画ループ——2Dステージと3Dステージ——に上限をかけるので、VRMのシーンとそのエフェクトも他のすべてと一緒に制限されます。高リフレッシュレートのディスプレイでは、上限を設けることで不要なGPU使用を抑えられます

エフェクト品質

3Dのビジュアルエフェクトに使うアンチエイリアスの方式を高、中、低から設定します。低いほど高速です

エフェクトをすべてオフにしたシーンではコストはかかりません

レンダリング解像度

3Dステージをどれだけ大きなキャンバスに描くかを選びます。倍率は100%、85%、75%、66%、50%。既定は100%です。デバイスピクセル比に掛かるので、実際のピクセル数はディスプレイの拡大率にも依存します

解像度を下げるとエフェクトチェーン全体の処理ピクセル数が減り、フレームレートの改善につながります。その分、アバターの輪郭や細かい模様はぼやけやすくなります

効くのはステージが描くものだけで、Live2Dモデルと2Dの画像・動画も含まれます。2Dのウェブページは独立したDOMレイヤーなので影響を受けません

保存場所

設定、シーン、APIキーはすべて~/.laplace/personaという1つのフォルダに保存されます。フォルダを開くを押すとファイルマネージャーでその場所が表示されます

バックアップ・移行・復元は、いずれもこのフォルダのコピーまたは置き換えです。先にPersonaを終了してください——動作中は自身の状態を書き戻すので、置いたばかりの内容が上書きされてしまいます

settings.jsonとscenes.jsonにはそれぞれのJSON Schema（設定、シーン）へのリンクが入っているので、VS Codeなどのエディターで入力しながら検証できます

ログを開くを押すと、同じフォルダの中のlogs/が表示されます。Personaはエラーと警告をつねにmain.logへ書き込みます。オンにするものは何もありません——このファイルはパソコンの外に出ることがなく、ネットワークを通る道はバグレポートを送信だけです。問題を報告するときは添付してください。2MBに達するとタイムスタンプ付きのアーカイブへローテーションし、新しいものから5つが残ります

プラグインAPI

設定の残りの部分では、他のアプリから操作するローカルWebSocketサーバーを有効にし、設定します——ポート、ローカルネットワークからのアクセス、APIキー、プラグインフォルダ、接続中のクライアント一覧です。専用のページがあります：プラグインAPI

初回起動

Personaをはじめて開くと、コントロールパネルの上に3ステップの案内が重なります。ようこそ、バグレポートを送信するかどうか、そして締めくくりの1ページです。バグレポートのステップには、レポートに何が含まれ、何が含まれないかが並びます。その下にあるプライバシーについて詳しく見るは、プライバシーとセキュリティをシステムのブラウザで開きます。最後のページで完了を押すと、この選択が「案内を見た」という印とともに設定へ書き込まれます

Esc や外側のクリックを受け付けないのは初回起動のときだけなので、ちょうど一度だけ目に入ります。そのあとはパネルヘッダーのメニューにある「オンボーディング…」からいつでも開き直せます。そのときは普通のダイアログなので閉じられますし、開くたびにそのときの設定を読み直します

以前のバージョンからアップグレードした環境でも一度は表示されます——この印の既定はオフで、それより前からある設定ファイルに勝手に付くことはありません

概要

パネルヘッダーのメニューにはドキュメント、Webコンソール、「オンボーディング…」もあります。前の2つはこのドキュメントとWebコンソールをシステムのブラウザで開き、最後の1つは初回起動の案内をもう一度開きます

LAPLACE Personaについて——パネルヘッダーのメニュー、トレイメニュー、そしてmacOSではアプリケーションメニューにあります——には、バージョン、制作に関わった人々を役割ごとに挙げたクレジット、プロジェクトが感謝する人々を挙げた謝辞、そしてそのビルドに同梱されたすべてのものについて、サードパーティに関する表示が並びます。Live2D Cubism Core、同梱モデル、VRMアニメーションと待機アニメーションのパックおよびそれらが求めるクレジット、同梱の環境マップと環境モデル、UIのフォント、そしてリップシンクが使うwLipSyncのライブラリと音声プロファイルです。最後のSpecial Thanksは、どの言語でも英語のまま表示されます

アップデート

バージョン番号はパネルヘッダーの右上にあります。これはアップデートの操作ボタンでもあります

Personaは起動からおよそ10秒後に一度、静かに確認し、その後はバージョンの行をクリックするたびに確認します。インストーラーはアップデートを選択したあとにダウンロードされます

アップデートの流れ

1. 確認——バージョンの行をクリックします。最新であればトーストでその旨が表示され、そうでなければアップデートダイアログが開きます
2. 選択——アップデートでダウンロードを開始、後でで閉じる、このバージョンをスキップでそのバージョンについて自動確認の通知を停止します。スキップしたバージョンも、自分でバージョンの行をクリックすれば表示されます
3. ダウンロード——進捗はダイアログに表示されます。Personaはそのまま使用でき、ダイアログを閉じてもダウンロードは中断されません
4. インストール——今すぐ再起動で即座に適用されます。そうしない場合は次回終了時にインストールされます

Personaが自動的に開始する外部通信は2種類です。アップデートの確認と、バグレポートを送信がオンのあいだのクラッシュレポートです。確認の宛先はdownloads.vrp.moeで、あらゆるファイルダウンロードに伴う情報以上の識別情報は運びません。バグレポートはそのスイッチでオフにできます。現在のインストーラーにはアップデート確認を無効にする設定がないため、確認を止めるにはこのホストをブロックしてください