「プログラミングは無機質なもの」と感じている人ほど、ハードウェアと画面がリアルタイムに連動する体験を一度も見ていないケースが多い。今回取り上げるArduino連携×Pygameのジャンプゲームは、Arduinoに接続したボタンを押すと、Pygameで描画されたキャラクターが障害物を飛び越えるという、極めてシンプルな構成のサンプルである。ポイントは、Arduinoから送られる「TRIGGER」という一行のシリアル文字列を、Python側で受信して条件分岐させているだけという点にある。この最小構成を理解したうえで生成AIを使いこなせば、コード解析からデバッグ、機能拡張までの工程を大幅に短縮できる。

本記事では、次の観点で解説を進める。第一に、コード全体がどのようなセクションで構成されているか。第二に、Arduinoから送られる「TRIGGER」信号が、どのタイミングでジャンプ処理につながっているか。第三に、実際に自分の環境で動かすために必要な設定値と手順である。あわせて、関連する電子工作の基礎記事も参考にしてほしい。

• 【2025年版】Arduinoのコードの書き方｜基礎から応用まで全てがわかる初心者の手引き
• 【徹底解説】Arduinoとブレッドボードで学ぶ！電子工作におけるボタン回路の基礎から応用まで

本題に入る前に、記事内で繰り返し登場する用語を整理しておく。

• Arduino：センサーやボタンなどの電子部品を制御できるマイコンボード。C/C++ベースの「スケッチ」と呼ばれるプログラムで動作する。
• Pygame：Python向けの2Dゲーム開発ライブラリ。画面描画、イベント処理、当たり判定などをシンプルなAPIで扱える。
• シリアル通信：USBケーブルなどを介して、1バイトずつ順番にデータをやり取りする通信方式。ArduinoとPCの間で最も一般的に使われる。
• pyserial：Pythonからシリアルポート（COMポートなど）を操作するための定番ライブラリ。import serialで読み込む。
• ボーレート（BAUD_RATE）：シリアル通信の速度を表す値。Arduino側とPC側で必ず一致させる必要がある。

今回のサンプルでは、ArduinoがボタンのON/OFFを検知し、押されたタイミングで"TRIGGER"という文字列をシリアル経由で送信する。Python側はこれをpyserialで受信し、文字列が一致した場合にのみキャラクターをジャンプさせる。この「送信側の一言」と「受信側の条件分岐」という構造が、ハードウェアとソフトウェアを疎結合につなぐ基本パターンである。

サンプルコードは長く見えるが、実際には大きく4つのブロックに分解できる。「シリアル通信の設定」「Pygameの初期設定」「プレイヤー／障害物のクラス定義」「メインループ（game_loop）」である。まずは全体像を俯瞰しておこう。

シリアル通信とPygameの初期化

シリアルポートの接続はpyserialを使い、以下のように実装されている。接続に失敗した場合はエラーメッセージを出力し、sys.exit()でプログラムを終了する設計になっている。

SERIAL_PORT = 'COM3'  # 環境に合わせて変更してください
BAUD_RATE = 9600
try:
    ser = serial.Serial(SERIAL_PORT, BAUD_RATE, timeout=1)
except Exception as e:
    print(f"シリアルポート {SERIAL_PORT} に接続できませんでした: {e}")
    sys.exit()

Pygame側では、ウィンドウサイズ（800×600）とタイトルを設定し、背景画像・キャラクター画像を読み込む。画像ファイルが存在しない場合はNoneを代入し、後の描画処理でデフォルトの図形描画にフォールバックする設計になっている点も実務上参考になる。

Player／Obstacleクラスと衝突判定

Playerクラスは座標・速度・ジャンプ中フラグを保持し、update()で毎フレーム重力を加算する。地面に到達すると速度をリセットし、再びジャンプ可能な状態に戻す。Obstacleクラスは幅・高さ・速度をランダムに決定し、画面右端から出現して左方向に移動する。衝突判定は、両者をpygame.Rectに変換しcolliderect()で矩形同士の重なりを判定するシンプルな実装である。

def check_collision(player, obstacle):
    p_rect = pygame.Rect(player.x, player.y, player.width, player.height)
    o_rect = pygame.Rect(obstacle.x, obstacle.y, obstacle.width, obstacle.height)
    return p_rect.colliderect(o_rect)

TRIGGER信号がジャンプに変換される瞬間

今回のコードで最も重要なのが、メインループ内の次の一節である。ここでArduinoからの受信データを読み取り、文字列が"TRIGGER"と一致した場合にのみplayer.jump()を呼び出している。

if ser.in_waiting and not game_over:
    try:
        line = ser.readline().decode('utf-8').strip()
    except UnicodeDecodeError:
        line = ""
    if line == "TRIGGER":
        player.jump()

Arduino側は、例えば以下のようなスケッチでボタンの押下を検知し、Serial.println("TRIGGER")を送信する。delay(200)はチャタリング対策と連続ジャンプの防止を兼ねている。

int buttonPin = 2;
int buttonState = 0;
void setup() {
  pinMode(buttonPin, INPUT_PULLUP);
  Serial.begin(9600);
}
void loop() {
  buttonState = digitalRead(buttonPin);
  if (buttonState == LOW) {
    Serial.println("TRIGGER");
    delay(200);
  }
}

圧力センサーや加速度センサーを使い、「値がある閾値を超えたらTRIGGERを送る」という条件に置き換えれば、操作デバイスは自由に拡張できる。センサーの選定や配線については、圧センサーの解説記事も参照してほしい。

【完全攻略】圧センサーを用いた電子工作の基礎編｜圧センサーの種類、配線、読み取り値など徹底解説

Arduinoとゲームを連携させる方法は、Pygame以外にも選択肢がある。学習目的か製品化目的かによって、最適な選択は変わる。以下は、代表的な3つの選択肢を比較したものである（編集部見解）。

ハードウェア連携の理解とプログラミングの基礎学習を同時に進めたい場合はA（Pygame）、将来的に本格的なゲーム開発やチーム開発を見据える場合はBまたはCが選択肢になる。今回のテーマである「シリアル通信の仕組みを理解する」という目的においては、環境構築の負荷が最も低いPygameが適している。

1. 環境準備
   Python 3系を用意し、pip install pygame pyserialで必要なライブラリをインストールする。
2. シリアルポートの指定
   Windowsの場合はデバイスマネージャーでCOMポート番号を確認し、SERIAL_PORT = 'COM3'を実際の値に書き換える。Mac／Linuxでは/dev/tty.*形式のパスになる。ボーレートはBAUD_RATE = 9600のまま、Arduino側のSerial.begin(9600)と一致させる。
3. Arduino側スケッチの書き込み
   ボタンをピン2に接続し、INPUT_PULLUP設定でLOW検知時にSerial.println("TRIGGER")を送信するスケッチを書き込む。delay(200)でチャタリングと連続送信を防止する。
4. Pygame側パラメータの確認
   重力GRAVITY = 0.5、ジャンプ初速JUMP_VELOCITY = -10、地面座標GROUND_Y = HEIGHT - 100がデフォルト値。ジャンプの高さや落下速度を変えたい場合はこの3値を調整する。
5. 動作確認
   clock.tick(60)で60FPSに固定されており、obstacle_timer > 90（約1.5秒ごと）で障害物が生成される。ボタンを押してキャラクターがジャンプし、障害物を飛び越えられれば設定完了。衝突するとゲームオーバー表示になり、Rキーでリセットできる。
6. （任意）AIを使った拡張・デバッグ
   動作確認ができたら、スコア表示やBGM追加などの改造はAIに雛形コードを作らせると早い。例えば「このコードに障害物を飛び越えた数をカウントして画面右上に表示する機能を追加して」のように、既存コード全文と要望をセットで渡すのがコツ。生成されたコードは必ず自分の環境で動作確認する。