English: README-EN.md

VRCWatch は、VRChat 内のアバター向けに現在時刻を送信するためのプログラムです。

1. 予め Python (バージョン 3.9 以降) をインストールします。
2. 初めて VRCWatch を起動する場合は setup.bat を実行します。
3. VRChat を起動します。
4. VRChat にて OSC が無効になっている場合は OSC を有効にします。
5. run.bat を実行します。
6. VRChat を終了した後は、run.bat で開かれたコマンドプロンプトを Ctrl キーを押しながら C キーを押して run.bat の実行を終了します。

このプログラムでは VRChat の OSC (OpenSound Control) 機能を利用して、 以下のパラメータを Avatar Parameter として送信します。 全てのパラメータは必ず DateTime から始まります。

• DateTimeYear
  • 型: 整数 (int)
  • グレゴリオ暦での年数です。
  • 2022 年であれば、2022 となります。
• DateTimeMonth
  • 型: 整数 (int)
  • グレゴリオ暦での月です。1 以上 12 以下の整数を取ります。
  • 1 月あれば、1 を、2 月であれば 2 を、12 月であれば 12 を取ります。
• DateTimeDay
  • 型: 整数 (int)
  • 当月内での日数です。1 以上 31 以下の整数を取ります。
  • 1 月 23 日であれば 23 を、2 月 29 日であれば、29 を、11 月 30 日であれば 30 を取ります。
• DateTimeWeekDay
  • 型: 整数 (int)
  • 1 週間内での曜日です。0 以上 6 以下の整数を取ります。
  • 月曜日は 0 を、火曜日は 1 を、水曜日は 2 を、土曜日は 5 を、日曜日は 6 を取ります。
• DateTimeHour
  • 型: 整数 (int)
  • 1 日を 24 分割している、時 (じ) です。0 以上 23 以下の整数を取ります。
  • 午前 0 時 12 分 (0:12) であれば 0 を、午後 3 時 45 分 (15:45) であれば 15 を、午後 11 時 59 分 (23:59) であれば 23 を取ります。
• DateTimeMinute
  • 型: 整数 (int)
  • 1 時間を 60 分割している、分です。0 以上 59 以下の整数を取ります。
  • 午前 1 時 00 分 (1:00) であれば 0 を、午後 2 時 34 分 (14:34) であれば 34 を、午後 11 時 59 分 (23:59) であれば 59 を取ります。
• DateTimeSecond
  • 型: 整数 (int)
  • 1 分間を 60 分割している、秒です。0 以上 59 以下の整数を取ります。
  • 午前 3 時 21 分 0 秒 (3:21:00) であれば 0 を、午後 1 時 23 分 45 秒 (13:23:45) であれば 45 を、午後 11 時 59 分 59 秒 (23:59:59) であれば 59 を取ります。
• DateTimeHourF
  • 型: 実数 (float)
  • DateTimeHour を 24 で割った、1/24 刻みの実数です。0 以上 1 未満を取ります。
  • 午前 1 時 23 分 (1:23) であれば約 0.04167 (= 1.0 / 24) を、午後 11 時 59 分 (23:59) であれば約 0.95833 (= 23.0 / 24) を取ります。
• DateTimeMinuteF
  • 型: 実数 (float)
  • DateTimeMinute を 60 で割った、1/60 刻みの実数です。0 以上 1 未満を取ります。
  • 午前 1 時 23 分 (1:23) であれば約 0.38333 (= 23.0 / 60) を、午後 11 時 59 分 (23:59) であれば約 0.98333 (= 59.0 / 60) を取ります。
• DateTimeSecondF
  • 型: 実数 (float)
  • DateTimeSecond を 60 で割った、1/60 刻みの実数です。0 以上 1 未満を取ります。
  • 午前 4 時 32 分 1 秒 (3:21:01) であれば約 0.01667 (= 1.0 / 60) を、午後 2 時 34 分 59 秒 (14:24:59) であれば約 0.98333 (= 59.0 / 60) を取ります。
• DateTimeDayTime
  • 型: 実数 (float)
  • 1 日の何割だけ時間が進んだかを表す実数です。0 以上 1 未満を取ります。
  • 午前 0 時 0 分 0 秒 (0:00:00) であれば 0.0 を、午後 12 時 59 分 59 秒 (23:59:59) を約 0.99999 を取ります。
• DateTimeHourFA
  • 型: 実数 (float)
  • DateTimeDayTime と同じ値です。
• DateTimeMinuteFA
  • 型: 実数 (float)
  • DateTimeMinuteF と同じ役割ですが、秒数も考慮してなめらかに増加します。
• DateTimeSecondFA
  • 型: 実数 (float)
  • DateTimeSecondF と同じ役割ですが、秒未満も考慮してなめらかに増加します。

Copyright (c) 2022 Kosaki Mezumona

MIT License, see LICENSE.