Poke-Controller

Pythonで書く！Switchの自動化支援ソフトウェア

セットアップと使い方

• まずはモノの準備

  • Github - wiki

• 準備ができたら進みましょう

  • Poke-Controllerの使い方

  • デフォルトの実装コマンドの確認

  • 新しいコマンドを作成

分からないことや改善要望などがあれば遠慮なくIssueまで
Q&Aや解決済みIssueなども役に立つかもしれません

クイックビュー

簡単に機能を見てみましょう

コマンド作成用のライブラリの提供

通常のボタン押下
self.press(Button.A) # Aボタンを押して離す
self.press(Button.A, 0.1, 1) # Aボタンを0.1秒間押して離した後, 1秒待機

左右スティック & HAT(十字)キー
self.press(Direction.RIGHT, 5) # 左スティックを右に5秒間倒す
self.press(Hat.LEFT) # 十字キー左を押して離す

同時押し
self.press([Button.A, Button.B]) # AボタンとBボタンを同時に押して離す

ホールド
self.hold([Direction.UP, Direction.R_DOWN], wait=1) # 左スティックを上, 右スティックを下に倒して1秒待つ
self.press(Button.A) # スティックを倒した状態でAボタンを押して離す

リファレンスやデフォルトのコマンドなども参考にして中身を覗いてみましょう
作成したコマンドや便利な機能はプルリクやIssueで頂けると非常に喜びます

Pythonファイル管理

作成したコマンドのclassは1つのPythonファイルの中にいくつも記述できます
またPythonCommandsのフォルダ内であればいくつもフォルダを作成可能です
自由に配置していきましょう

実行時のコマンド切替

配置したコマンド群はマウス操作で簡単に切り替えることができます

リロード機能

Poke-Controllerを動作しながらファイルの変更を再読込して反映することができます
こつこつデバグしたい方におすすめ！

画像認識

キャプチャボードでSwitchの画面を取り込めば, シリアル通信だけでは叶わない操作もできるかも
これらもライブラリとして機能を提供しています
self.isContainTemplate('status.png') # テンプレートマッチング

現在の機能(実装内容)は少ないがアップデート予定

キーボード操作

キーボードをスイッチのコントローラとして使用することができます

Switchコントローラ	キーボード
A, B, X, Y, L, R	'a', 'b', ...キー
ZL	'k'キー
ZR	'e'キー
MINUS	'm'キー
PLUS	'p'キー
LCLICK	'q'キー
RCLICK	'w'キー
HOME	'h'キー
CAPTURE	'c'キー
左スティック	矢印キー

リリース

• 過去リリース

  • Github - Releases

• 進捗状況の確認

  • Github - Project

• ロードマップ

  • リリースについて

貢献

これらの貢献者に感謝します (emoji key):

KawaSwitch 💻 🚧 📖 💬

Moi-poke 💻 💬

xv13 🐛

vyPeony 💻

このプロジェクトは, all-contributors仕様に準拠しています. どんな貢献も歓迎します！

ライセンス

本プロジェクトはMITライセンスです
詳細は LISENCE を参照ください

また, 本プロジェクトではLGPLライセンスのDirectShowLib-2005.dllを同梱し使用しています
About DirectShowLib