Skip to content

外付けデバイス ​

TIP

ソフトウェアは現在も継続的に更新されているため、関連するオプションや説明が古くなっている可能性があります。このページで要件を満たせない場合は、QQ グループ 667644338 に参加して質問・議論してください。

MajdataPlay は一般的な maimai 用コントローラーに対応しています。キーボードエミュレーション、HID ボタンリング、シリアルポート接続のタッチパネル、シリアル / HID LED などが含まれます。ほとんどの場合、ゲームがデバイスを自動で認識します。認識できない場合は、system-settings.json の IO セクションで手動で指定してください。

Windows / macOS / Linux ​

設定は system-settings.json にあります。

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 クラスのデバイス
YuanYuan コントローラー (ADX)
DaoDao コントローラー
NovNov コントローラー
NProNPro コントローラー
Pipe外部 IO マネージャー
null自動認識

IO.InputDevice.ButtonRing.Type には "Keyboard"、"HID"、"Pipe" を指定できます。null の場合、ボタンリングはデフォルトでキーボードとして扱われます。一般的な組み合わせは次のとおりです。

コントローラーManufacturerButtonRing.Type
キーボードGeneralKeyboard
ADX / Yuan コントローラー HIDYuanHID
IO4 / 汎用 HIDGeneralHID
Dao HID (実験的)DaoHID
外部 IO マネージャーPipePipe

シリアルポート ​

デフォルトでは、1P のタッチパネルは COM3、LED は COM21 を使用します。2P はそれぞれ COM4 と COM22 を使用します。タッチパネルのデフォルトのボーレートは 9600、LED のデフォルトのボーレートは 115200 です。

デバイスがデフォルトのポートにない場合は、次の項目を変更してください。

  • IO.InputDevice.TouchPanel.SerialPortOptions.Port / BaudRate
  • IO.OutputDevice.Led.SerialPortOptions.Port / BaudRate

Windows ではポートを整数で指定します (例: 3 は COM3)。その他のプラットフォームでは文字列で指定します (例: "/dev/ttyACM0")。

HID ボタンリング ​

"HID" を使用する場合は、通常 PID と VID も入力する必要があります。以下は一般的なコントローラーのデフォルト値です。いずれも HidOptions に10 進数で入力します。

コントローラーProductId (PID)VendorId (VID)
ADX / Yuan コントローラー HID2235211836
IO4 / 汎用 HID333235
Dao HID46443727

デバイスの 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 系) に追加してから、再ログインするか再起動してください。

bash
sudo usermod -a -G dialout,uucp $USER

続いて udev ルールを追加します。

bash
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 進数です。

bash
sudo udevadm control --reload-rules
sudo udevadm trigger

その後、USB ケーブルを挿し直してください。接続に成功したらゲームを再起動してください。

モバイル ​

モバイル版にはデスクトップ版のようなシリアル / HID 設定はなく、外付けのボタンリングを 1 つだけ使用します。

json
"IO": {
    "InputDevice": {
      "ExternalButtonRing": "None"
  }
}

コントローラーが次の入力方式を使用する場合は、値を変更してください。

  • キーボード入力の場合は "None" を "Keyboard" に変更します
  • ゲームパッド入力の場合は "None" を "Gamepad" に変更します