外付けデバイス
TIP
ソフトウェアは現在も継続的に更新されているため、関連するオプションや説明が古くなっている可能性があります。このページで要件を満たせない場合は、QQ グループ 667644338 に参加して質問・議論してください。
MajdataPlay は一般的な maimai 用コントローラーに対応しています。キーボードエミュレーション、HID ボタンリング、シリアルポート接続のタッチパネル、シリアル / HID LED などが含まれます。ほとんどの場合、ゲームがデバイスを自動で認識します。認識できない場合は、system-settings.json の IO セクションで手動で指定してください。
Windows / macOS / Linux
設定は system-settings.json にあります。
"IO": {
"Manufacturer": "General",
"Player": 1,
"InputDevice": {
"ButtonRing": {
"Type": "HID",
"Debounce": true,
"PollingRateMs": 2,
"DebounceThresholdMs": 5,
"HidOptions": {
"ProductId": 33,
"VendorId": 3235
}
},
"TouchPanel": {
"SerialPortOptions": {
"Port": 3,
"BaudRate": 9600
}
}
},
"OutputDevice": {
"Led": {
"SerialPortOptions": {
"Port": 21,
"BaudRate": 115200
}
}
}
}null は自動認識を意味します。サポートされている Manufacturer の値は次のとおりです。
| 値 | 説明 |
|---|---|
General | 汎用 / IO4 クラスのデバイス |
Yuan | Yuan コントローラー (ADX) |
Dao | Dao コントローラー |
Nov | Nov コントローラー |
NPro | NPro コントローラー |
Pipe | 外部 IO マネージャー |
null | 自動認識 |
IO.InputDevice.ButtonRing.Type には "Keyboard"、"HID"、"Pipe" を指定できます。null の場合、ボタンリングはデフォルトでキーボードとして扱われます。一般的な組み合わせは次のとおりです。
| コントローラー | Manufacturer | ButtonRing.Type |
|---|---|---|
| キーボード | General | Keyboard |
| ADX / Yuan コントローラー HID | Yuan | HID |
| IO4 / 汎用 HID | General | HID |
| Dao HID (実験的) | Dao | HID |
| 外部 IO マネージャー | Pipe | Pipe |
シリアルポート
デフォルトでは、1P のタッチパネルは COM3、LED は COM21 を使用します。2P はそれぞれ COM4 と COM22 を使用します。タッチパネルのデフォルトのボーレートは 9600、LED のデフォルトのボーレートは 115200 です。
デバイスがデフォルトのポートにない場合は、次の項目を変更してください。
IO.InputDevice.TouchPanel.SerialPortOptions.Port/BaudRateIO.OutputDevice.Led.SerialPortOptions.Port/BaudRate
Windows ではポートを整数で指定します (例: 3 は COM3)。その他のプラットフォームでは文字列で指定します (例: "/dev/ttyACM0")。
HID ボタンリング
"HID" を使用する場合は、通常 PID と VID も入力する必要があります。以下は一般的なコントローラーのデフォルト値です。いずれも HidOptions に10 進数で入力します。
| コントローラー | ProductId (PID) | VendorId (VID) |
|---|---|---|
| ADX / Yuan コントローラー HID | 22352 | 11836 |
| IO4 / 汎用 HID | 33 | 3235 |
| Dao HID | 4644 | 3727 |
デバイスの PID / VID がわからない場合は、Windows のデバイスマネージャーで該当する HID デバイスを見つけ、プロパティ > 詳細 を開いて デバイス インスタンス パス を選択してください。そこに含まれる VID_xxxx と PID_xxxx は16 進数です。まず 10 進数に変換してから system-settings.json に入力してください。
デバウンスとポーリング
- ボタンが二重に反応したり、「キーのチャタリング」を感じる場合は、
IO.InputDevice.ButtonRing.DebounceThresholdMsを大きくしてください。 - 入力のカクつきやフレーム落ちを感じる場合は、
IO.InputDevice.ButtonRing.PollingRateMsを適切に大きくしてください (例:2)。ただし、値が大きすぎると判定が悪化する可能性があります。 - タッチパネルと LED にも対応する
PollingRateMs/DebounceThresholdMsがあり、構造は同じです。
Linux の権限
コントローラーを接続してもボタンとタッチパネルが反応しない場合は、現在のユーザーを dialout グループ (ほとんどのディストリビューション) または uucp グループ (Arch Linux 系) に追加してから、再ログインするか再起動してください。
sudo usermod -a -G dialout,uucp $USER続いて udev ルールを追加します。
sudo nano /etc/udev/rules.d/99-maicontrollers-hid.rulesルールの内容は次のとおりです。
KERNEL=="ttyACM[0-9]*", MODE="0666", GROUP="dialout"
KERNEL=="ttyUSB[0-9]*", MODE="0666", GROUP="dialout"
# General IO4 Controller
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0ca3", ATTRS{idProduct}=="0021", GROUP="plugdev", MODE="0660"
# ADX Controller
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="2e3c", ATTRS{idProduct}=="5750", GROUP="plugdev", MODE="0660"
# Dao Controller
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0e8f", ATTRS{idProduct}=="1224", GROUP="plugdev", MODE="0660"デバイスが上記の 3 種類と一致しない場合は、対応する idVendor (VID) と idProduct (PID) を変更してください。udev ルール内の値は16 進数です。
sudo udevadm control --reload-rules
sudo udevadm triggerその後、USB ケーブルを挿し直してください。接続に成功したらゲームを再起動してください。
モバイル
モバイル版にはデスクトップ版のようなシリアル / HID 設定はなく、外付けのボタンリングを 1 つだけ使用します。
"IO": {
"InputDevice": {
"ExternalButtonRing": "None"
}
}コントローラーが次の入力方式を使用する場合は、値を変更してください。
- キーボード入力の場合は
"None"を"Keyboard"に変更します - ゲームパッド入力の場合は
"None"を"Gamepad"に変更します
