メインコンテンツまでスキップ

@hmcs/settings

設定 MOD（@hmcs/settings）は、レンダリングや表示のプリファレンスを調整するためのアプリケーション全体の設定パネルを提供します。キャラクターを右クリックせずに開けるよう、システムトレイメニューエントリを登録します。

概要​

システムトレイアイコンから設定パネルを開きます：

  1. OS のメニューバー/システムトレイにある Desktop Homunculus のトレイアイコンをクリック
  2. 「Settings」 を選択
  3. 設定パネルがフローティング WebView ウィンドウとして開きます

機能​

変更は Save をクリックした後に反映されます。すべての設定は ~/.homunculus/preferences.db に保存されます。

フレームレート​

設定説明範囲
フレームレートレンダリングのフレームレートを制御します。値を下げると CPU/GPU 使用率が低下します。1 fps 以上

影の不透明度​

設定説明範囲
影の不透明度キャラクターの背後にある影パネルオーバーレイの透明度を制御します。0 - 100%

SDK​

@hmcs/sdk の settings 名前空間から、アプリケーション設定にプログラムでアクセスできます：

import { settings } from "@hmcs/sdk";

// 現在の FPS を取得
const currentFps = await settings.fps();

// 新しい FPS 値を設定
await settings.setFps(30);

API の完全なドキュメントは Settings SDK リファレンスをご覧ください。

備考​

  • 設定 MOD はコンテキストメニューではなくトレイメニューを使用します。これは、アプリケーション設定が特定のキャラクターに紐づかないためです。
  • 設定パネルの UI は共有の @hmcs/ui コンポーネント（component）ライブラリを使用しています。