every_holiday/VRCT
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
6fc89fbb3e8c3c477b30601cf6e9da44610b8297
VRCT/src-python/docs/details/config.md
misyaguziya d1aef28c7a Add comprehensive detailed design documents
2025-10-14 07:28:03 +09:00

8.3 KiB
Raw Blame History

config.py - 設定管理モジュール

概要

VRCTアプリケーションの全設定を一元管理するモジュールです。シングルトンパターンを採用し、アプリケーション全体で統一された設定アクセスを提供します。JSON設定ファイルの読み書き、設定の永続化、デバウンス機能付き保存機能を提供します。

主要機能

シングルトン設計

  • アプリケーション全体で単一の設定インスタンス
  • スレッドセーフな設定アクセス
  • 遅延初期化による軽量インポート

設定永続化

  • JSON形式での設定ファイル管理
  • デバウンス機能付き自動保存
  • 設定変更の即座反映

動的設定管理

  • 実行時設定変更対応
  • デバイス情報の動的取得
  • 言語・エンジン設定の自動更新

型安全な設定アクセス

  • プロパティベースのアクセス制御
  • 読み取り専用・読み書き可能設定の分離
  • デコレータによるシリアライゼーション管理

クラス構造

Config クラス

class Config:
    _instance = None              # シングルトンインスタンス
    _config_data: Dict[str, Any]  # 設定データ
    _timer: Optional[threading.Timer]  # デバウンスタイマー
    _debounce_time: int = 2       # デバウンス時間（秒）

設定カテゴリ

読み取り専用設定

@property
def VERSION(self) -> str
  • アプリケーションバージョン
@property
def PATH_LOCAL(self) -> str
  • ローカルディレクトリパス
@property
def PATH_CONFIG(self) -> str
  • 設定ファイルパス

UI・表示設定

@property
def UI_LANGUAGE(self) -> str
  • UIの表示言語
@property  
def TRANSPARENCY(self) -> int
  • ウィンドウの透明度（0-100）
@property
def UI_SCALING(self) -> int
  • UIのスケーリング（50-200%）
@property
def FONT_FAMILY(self) -> str
  • 使用フォントファミリー

翻訳設定

@property
def ENABLE_TRANSLATION(self) -> bool
  • 翻訳機能の有効・無効
@property
def SELECTED_TRANSLATION_ENGINES(self) -> Dict[str, str]
  • 選択されている翻訳エンジン
@property
def SELECTED_YOUR_LANGUAGES(self) -> Dict[str, Dict[str, Any]]
  • 送信言語設定
@property
def SELECTED_TARGET_LANGUAGES(self) -> Dict[str, Dict[str, Any]]
  • 受信言語設定

音声認識設定

@property
def ENABLE_TRANSCRIPTION_SEND(self) -> bool
  • 送信音声認識の有効・無効
@property
def SELECTED_TRANSCRIPTION_ENGINE(self) -> str
  • 音声認識エンジン
@property
def SELECTED_MIC_DEVICE(self) -> str
  • 選択されたマイクデバイス
@property
def MIC_THRESHOLD(self) -> int
  • マイク音声しきい値
@property
def MIC_RECORD_TIMEOUT(self) -> int
  • マイク録音タイムアウト（秒）

VR設定

@property
def OVERLAY_SMALL_LOG(self) -> bool
  • 小型ログオーバーレイの有効・無効
@property
def OVERLAY_SMALL_LOG_SETTINGS(self) -> Dict[str, Any]
  • 小型オーバーレイの詳細設定
@property
def OVERLAY_LARGE_LOG_SETTINGS(self) -> Dict[str, Any]
  • 大型オーバーレイの詳細設定

通信設定

@property
def OSC_IP_ADDRESS(self) -> str
  • OSC通信IPアドレス
@property
def OSC_PORT(self) -> int
  • OSC通信ポート
@property
def WEBSOCKET_HOST(self) -> str
  • WebSocketサーバーホスト
@property
def WEBSOCKET_PORT(self) -> int
  • WebSocketサーバーポート

計算デバイス設定

@property
def SELECTED_TRANSLATION_COMPUTE_DEVICE(self) -> Dict[str, Any]
  • 翻訳用計算デバイス
@property
def SELECTED_TRANSCRIPTION_COMPUTE_DEVICE(self) -> Dict[str, Any]
  • 音声認識用計算デバイス

主要メソッド

設定保存

saveConfig(key: str, value: Any, immediate_save: bool = False) -> None
  • 設定値の保存（デバウンス付き）
  • immediate_save=Trueで即座保存
saveConfigToFile() -> None
  • 設定ファイルへの直接保存

初期化・設定読み込み

init_config() -> None
  • 設定の初期化
  • デフォルト値の設定
load_config() -> None
  • 設定ファイルからの読み込み
  • 存在しない場合はデフォルト設定を作成

デコレータ機能

@json_serializable

@json_serializable("setting_name")
@property
def SETTING_NAME(self) -> Any:
  • 設定のJSONシリアライゼーション対象指定
  • 自動的にconfig.jsonに保存される設定を定義

使用方法

基本的な使い方

from config import config

# 設定値の取得
version = config.VERSION
ui_language = config.UI_LANGUAGE
translation_enabled = config.ENABLE_TRANSLATION

# 設定値の変更
config.UI_LANGUAGE = "ja"
config.TRANSPARENCY = 80
config.MIC_THRESHOLD = 1500

複雑な設定の変更

# 翻訳エンジンの設定
engines = config.SELECTED_TRANSLATION_ENGINES
engines["1"] = "DeepL"
config.SELECTED_TRANSLATION_ENGINES = engines

# オーバーレイ設定の変更
overlay_settings = config.OVERLAY_SMALL_LOG_SETTINGS
overlay_settings["x_pos"] = 0.5
overlay_settings["opacity"] = 0.8
config.OVERLAY_SMALL_LOG_SETTINGS = overlay_settings

即座保存

# 重要な設定変更時の即座保存
config.saveConfig("ENABLE_TRANSLATION", True, immediate_save=True)

設定ファイル形式

設定はconfig.jsonファイルにJSON形式で保存されます：

{
    "UI_LANGUAGE": "ja",
    "TRANSPARENCY": 85,
    "UI_SCALING": 100,
    "ENABLE_TRANSLATION": true,
    "SELECTED_TRANSLATION_ENGINES": {
        "1": "DeepL",
        "2": "Google",
        "3": "CTranslate2"
    },
    "OVERLAY_SMALL_LOG_SETTINGS": {
        "x_pos": 0.0,
        "y_pos": -0.4,
        "z_pos": 1.0,
        "opacity": 1.0,
        "ui_scaling": 1.0,
        "display_duration": 5,
        "fadeout_duration": 1
    }
}

デフォルト設定

UI設定

  • UI言語: "en"（英語）
  • 透明度: 85%
  • UIスケーリング: 100%
  • フォント: "Noto Sans JP"

翻訳設定

  • 翻訳機能: 無効
  • デフォルトエンジン: "Google"
  • 送信言語: English（US）
  • 受信言語: 日本語

音声認識設定

  • 送信音声認識: 無効
  • 受信音声認識: 無効
  • 音声認識エンジン: "Google"
  • マイクしきい値: 300

VR設定

  • 小型オーバーレイ: 無効
  • 大型オーバーレイ: 無効
  • オーバーレイ位置: HMD正面

通信設定

  • OSC IP: "127.0.0.1"
  • OSC ポート: 9000
  • WebSocket ホスト: "127.0.0.1"
  • WebSocket ポート: 8765

依存関係

必須依存関係

  • json: 設定ファイルのシリアライゼーション
  • threading: デバウンス機能
  • typing: 型注釈

オプション依存関係

  • device_manager: デバイス情報取得
  • torch: CUDA計算デバイス情報
  • 各種モデルモジュール: 言語・エンジン情報

エラーハンドリング

  • 設定ファイル読み込みエラーの適切な処理
  • 不正な設定値の検証・補正
  • オプション依存関係の欠如に対するフォールバック
  • ファイル書き込みエラーの処理

パフォーマンス特性

デバウンス機能

  • 設定変更から2秒後に自動保存
  • 連続する変更の統合
  • I/O負荷の軽減

遅延初期化

  • 重い依存関係の遅延読み込み
  • インポート時間の短縮

メモリ効率

  • 設定データのシングルトン管理
  • 不要な複製の防止

注意事項

  • 設定変更は即座にメモリに反映される
  • ファイル保存はデバウンス機能により遅延される
  • 重要な設定はimmediate_save=Trueを使用
  • オプション依存関係の欠如時はデフォルト値を使用
  • 不正な設定値は自動的に補正される
  • 設定ファイルが破損した場合は新規作成される

セキュリティ考慮事項

  • 設定ファイルの適切な権限管理
  • 外部入力値の検証
  • APIキー等の機密情報の適切な取り扱い
  • パスインジェクション攻撃の防止
Reference in New Issue View Git Blame Copy Permalink