【豊田祭2026】ARスタンプラリーの開発記録

プログラミング部2年が豊田祭で開催した「ARスタンプラリー」の制作報告です。会場の6か所のマーカーをスマートフォンのカメラで読み取り、スタンプを集める企画で、アプリのインストールは不要です。フロントエンド・AR・バックエンドの各技術と、誤認識防止などの工夫、マーカー認識で苦労した点、当日の結果とアンケートから見えた課題、チーム開発の振り返りを紹介します。

はじめに

ここでは10月31日(土)、11月1日(日)に開催された豊田祭でプログラミング部2年が開催した「ARスタンプラリー」について、使用した技術や工夫したこと、苦労した点などをまとめた。

また、ARスタンプラリーに参加し、アンケートにご回答いただいた方々に改めて感謝申し上げます。

ARスタンプラリーとは

ARスタンプラリーとは、豊田祭の会場に設置された6か所のARマーカーをスマートフォンのカメラで読み取り、スタンプを集めて答えを回答するWebアプリである。

マーカーを読み取ると、画面上に画像が表示される。6個すべてのスタンプを集めると「こ・ん・び・ビ・あ・る」の6文字がそろい、ConvivialNetのブースエリアで景品と交換することができる企画である。

当日は、下のチラシを配布して参加を呼びかけた。チラシのQRコードからスタンプラリーのサイトにアクセスでき、アプリのインストールは不要である。6個すべてのスタンプを集めると、先着で参加賞(お菓子)をプレゼントした。

ConvivialNetのブースでは、スタンプラリーのほかにゲームの展示も行った。また、同じConvivialNetのネットワーク部がFree Wi-Fiを提供したため、来場者は通信量を気にせずに参加することができた。

A3

フロントエンド技術について

使用技術


本システムのフロントエンドは、スマートフォンのブラウザから利用することを前提に、HTML・CSS・JavaScriptで構築した。

アイコンにはGoogleのMaterial Iconsを使用し、メニューやカメラ、ヘルプなどのボタンを直感的に分かる見た目にした。

スマートフォンの画面幅に合わせて表示が変わるよう、viewportの設定とレスポンシブ対応を行った。

758289DA-E86F-4067-B42D-0E62856D9B35

実装内容


画面構成

画面は、操作の迷いが出ないよう次のように分けた。

  • 上部:タイトル、集めた文字の確認ボタン、Wi-Fi表示、メニューボタン
  • 中央:会場マップ
  • 下部:解答ボタン、カメラ起動ボタン、チュートリアルボタン

初めて使う来場者でも、「何をすればよいか」が一目で分かる画面を目指した。

集めた文字一覧

「集めた文字」ボタンを押すと、取得状況を確認できる一覧画面が開く。

画面には残数を表示し、未取得のスタンプは「?」、取得済みのスタンプは取得した文字で表示する。これにより、あと何個で達成できるのかが分かり、集める楽しさにつながるようにした。 564ae30b-ffa6-4f0a-acb0-17c634fdd8b6

会場マップとスポット紹介

大学の地図の上に、スタンプの設置場所となる6か所を表示した。

  • ステージ横
  • 11号館前
  • ConvivialNetブース
  • 15号館前
  • 出店
  • 道

未取得のスポットはマップ上に「?」で表示し、スタンプを取得すると表示が取得した文字に切り替わる。これにより、どこを回り終えて、どこがまだ残っているのかが地図上で一目で分かる。

各スポットをタップすると、場所の説明文と写真がポップアップで表示される。説明文には、場所を探すヒントや豊田祭ならではの紹介文を入れ、来場者が会場を歩きながら楽しめるようにした。

170ca11c-6a31-4ca4-85ce-ff23b3432a2a

メニュー

画面右上のメニューから、次のページへ移動できる。

項目 内容
ユーザー情報 利用者の情報の確認
ホーム スタンプラリーのトップ画面
お問い合わせ 運営への連絡フォーム
ご案内 企画の案内や注意事項
利用規約 利用にあたっての規約

これらの画面は、バックエンドのUser APIやContact APIと連携している。

カメラ起動とチュートリアル

カメラボタンを押すとAR読み取り画面に切り替わり、マーカーを読み取れる。

また、初めて使う人向けに「チュートリアル」ボタンを用意し、遊び方をいつでも見返せるようにした。説明を別ページにせず、同じ画面から開けるようにして、迷子にならないよう配慮した。

解答画面

6文字を集めたあとは、「解答はこちら」ボタンから答えを入力して回答できる。正解すると景品交換の案内が表示される。

この部分はバックエンドのPrize APIと連携している。

工夫した点


・ 画面を「マップ」「集めた文字」「メニュー」に整理し、初めてでも迷わない構成にした

・ 未取得を「?」で表示し、残り個数も示して、収集の達成感が出るようにした

・ スポットの紹介文と写真を表示し、来場者が会場を楽しみながら探せるようにした

・ チュートリアルをいつでも開けるようにした

・ アイコンを使い、文字が読みにくい屋外のスマートフォン画面でも操作しやすくした

・ マップをスタンプ範囲だけに限定し拡大して配置した

フロントエンド技術について__まとめ


フロントエンドでは、スマートフォンでの利用を前提に、マップ・スタンプ一覧・メニューを中心とした分かりやすい画面を実装した。AR機能とバックエンドをつなぐ入り口として、誰でも迷わず参加できる使いやすさを意識した。

AR技術について

使用技術


本システムでは、Webブラウザ上でAR(拡張現実)を実現するために、A-FrameとAR.jsを使用した。

A-Frame

A-FrameはWebブラウザ上で3DコンテンツやVR・ARコンテンツを作成するためのJavaScriptフレームワークである。本システムではAR空間の生成や3Dオブジェクトの表示に利用した。

AR.js

AR.jsはブラウザ上でAR機能を実現するライブラリであり、スマートフォンのカメラ映像からマーカーを検出できる。本システムではスタンプ用マーカーの認識処理に利用した。

実装内容


マーカー認識によるスタンプ取得

あらかじめ作成したパターンマーカー(.pattファイル)を設置し、利用者がスマートフォンのカメラで読み取ることでスタンプを取得できる仕組みを実装した。

各マーカーには固有のIDとスタンプ名を設定し、認識時に対応するスタンプ画像をAR表示するようにした。

例:

  • stamp-1:「こ」
  • stamp-2:「ん」
  • stamp-3:「び」
  • stamp-4:「ビ」
  • stamp-5:「あ」
  • stamp-6:「る」

誤認識防止機能

マーカーを検出した瞬間にスタンプを取得するのではなく、約2.5秒間連続して認識された場合のみ取得成功とした。

これにより、

  • 一瞬映り込んだだけの場合
  • カメラのブレによる誤認識
  • 通り過ぎただけの場合

などの不要なスタンプ取得を防止できた。

スタンプの重複取得防止

同じスタンプを再度読み取った場合は「取得済みのスタンプです」と表示する機能を実装した。

これにより、同じ場所で何度もスタンプを取得できないようにした。

サーバとのデータ連携

スタンプ取得時にはfetch APIを利用してサーバへ以下の情報を送信した。

  • ユーザーID
  • スタンプ番号
  • スタンプ名

サーバ側では取得履歴をデータベースへ保存し、ユーザーごとのスタンプ収集状況を管理できるようにした。

カメラズーム機能

スマートフォンでの利用を考慮し、ピンチ操作によるズーム機能を追加した。

2本指で画面を拡大・縮小すると、カメラのズーム倍率が変更されるため、遠くにあるマーカーや小さいマーカーも読み取りやすくなった。

ローディング画面

ARカメラ起動時にはカメラの初期化に時間がかかるため、「カメラ起動中」のローディング画面を表示した。

カメラの準備完了後に自動で非表示にすることで、利用者に現在の状態を分かりやすく伝えられるようにした。

工夫した点


・ AR.jsを利用してアプリのインストール不要でAR体験を実現した

・ マーカー認識時間を設けて誤取得を防止した

・ サーバと連携して取得履歴をデータベースに保存した

・ ピンチズーム機能により認識精度と操作性を向上させた

・ マーカー誤認識を避けるため、pattファイルを識別しやすいように変更した

AR技術について__まとめ


本システムではA-FrameとAR.jsを利用したマーカーベースARを採用した。ユーザーはスマートフォンのカメラでマーカーを読み取るだけでスタンプを取得できる。さらに、誤認識防止機能やズーム機能、データベース連携機能を実装することで、実用的かつ操作しやすいARスタンプラリーシステムを実現した。

バックエンド技術について

使用技術


FastAPI

本システムでは、Python製のWeb APIフレームワークであるFastAPIを使用した。

FastAPIは高速な処理性能を持ち、API開発を効率的に行える特徴がある。本システムではフロントエンドとデータベースをつなぐ役割を担っている。

実装内容


API機能の分割

機能ごとにルーター(Router)を分割し、システムの保守性を向上させた。

実装した主なAPIは以下の通りである。

機能 内容
Contact API お問い合わせ機能
User API ユーザー管理機能
Admin API 管理者機能
Stamp API スタンプ取得機能
FAQ API よくある質問機能
Prize API 景品交換機能

機能ごとにファイルを分離することで、ソースコードの可読性と保守性を高めた。

管理者画面

運営側がスタンプの取得状況や問い合わせを確認できるよう、管理者専用の画面を用意した。管理者としてログインすると、「スタンプ管理」と「お問い合わせ管理」の2つのメニューが表示される。

スタンプ管理画面では、次の情報を確認できる。

  • 登録ユーザー数
  • 総取得数
  • コンプリート人数
  • ユーザーごとの取得数(例:6/6)、景品の受取状況(受取済み/未受取)、登録日時

景品の受取状況を管理画面で確認できるため、景品の渡し間違いや二重受取を防ぐことができた。

また、お問い合わせ管理画面では、来場者から届いた問い合わせを確認できるようにした。今回は問い合わせは届かなかった。

セッション管理

利用者のログイン状態や認証情報を安全に管理するため、SessionMiddlewareを利用した。

セッション情報はブラウザのCookieに保存され、サーバ側で利用者を識別できるようになっている。

また、

  • セッション有効時間:1時間
  • セキュリティキーによる暗号化
  • HTTPS通信時の保護

などの設定を行い、安全性を向上させた。

CORS設定

フロントエンドとバックエンド間でデータ通信を可能にするため、CORS(Cross-Origin Resource Sharing)を設定した。

本システムではJavaScriptからFastAPIへAPIリクエストを送信し、スタンプ取得やユーザー情報の取得を行っている。

フロントエンドとの連携

ARスタンプ取得時にはJavaScriptのfetch APIを利用してFastAPIへリクエストを送信する。

受信した情報をもとにサーバ側で処理を行い、データベースへ保存する仕組みを構築した。

送信される情報の例

  • ユーザーID
  • スタンプ番号
  • スタンプ名

苦労した点


マーカー認識の精度

開発中は問題なく読み取れていたが、本番では設置場所の明るさや角度によって読み取りにくい場面があった。「び」と「ビ」のマーカー柄が似ていたことによる誤認識も起き、pattファイルを識別しやすいものに変更して対応した。ただし、本番環境でのテスト不足により、十分な対策には至らなかった。詳しくは「今後の課題」に記載する。

工夫した点


・ 機能ごとにRouterを分離し、保守しやすい構成にした

・ SessionMiddlewareを用いてセッション管理を実現した

・ 環境変数を利用して機密情報を安全に管理した

・ 管理者画面で取得状況と景品の受取状況を確認できるようにし、当日の景品交換を円滑にした

・ CORS設定によりフロントエンドとの連携を実現した

・ FastAPIを利用し、高速なAPI処理を可能にした

バックエンド技術について__まとめ


バックエンドにはFastAPIを採用し、スタンプ取得機能やユーザー管理機能などをAPIとして実装した。また、セッション管理やCORS設定を行うことで、フロントエンドと安全かつ円滑に連携できるシステムを構築した。

結果と今後の課題

当日の結果


豊田祭2日間の結果は次の通りである。

項目 結果
登録ユーザー数 109人
総スタンプ取得数 460個
コンプリート人数 63人

登録ユーザー1人あたりの平均取得数は約4.2個で、登録者のうち約58%(63人)が6個すべてを集めた。半数を超える参加者が最後まで遊んでくれたことは、企画として大きな成果だと感じている。

お問い合わせは、今回は1件も届かなかった。

アンケート結果


参加者にはすべてのスタンプを取得した後、Googleフォームでアンケートへの回答をお願いした。

好評だった点

・ 「楽しかった」「面白かった」という感想が多かった

・ 会場を歩いてスタンプを探す体験そのものが楽しかったという声があった

・ 学校の中を見て回れてよかったという意見があった

・ ConvivialNetブースで展示していたゲームも楽しかったという声があった

改善点として挙がった意見

・ 場所が分かりにくい、一部のスポットが難しかった

・ 読み込みエラーが何度か出てスタンプを取得できなかった

・ 15号館前の「び」が、読み取っていないのに取得済みになった

・ 会場内をかなり歩く必要があった

好評の声がある一方で、「読み込みエラー」と「誤取得」という、システム面での課題も明らかになった。

今後の課題


アンケートと当日の運用をふまえ、今後は次の点を改善したい。

読み込みエラーの解消

スムーズに読み込めなかったという意見があった。原因を調べたところ、ARマーカーが暗い場所に設置されていると読み取りにくいことが、開催後に分かった。事前に会場で全マーカーの読み取りテストを行っていれば気付けた問題であり、確認が不足していたことが悔やまれる。

また、カメラの角度によっても読み込みにくくなることが分かった。今後は次の対策を行いたい。

・ 設置前に、現地の明るさのもとで全マーカーの読み取りテストを行う

・ 暗い場所には照明を当てる、または設置場所を変更する

・ 斜めからでも読み取れるよう、マーカーのサイズや設置の高さ・向きを見直す

誤取得の防止

15号館前の「び」を読み取っていないのに取得済みになった、という報告があった。「び」と「ビ」のマーカー柄が似ており、別のマーカーを誤認識した可能性がある。

pattファイルを識別しやすいように変更して対応したが、十分な改善には至らなかった。今後は、文字ごとに柄を大きく変える、読み取りの判定を厳しくする、といった対策を検討したい。

場所の分かりやすさ

場所が分かりにくい、歩く距離が長いという意見があった。マップをスタンプ範囲だけに絞って拡大するなどの工夫はしたが、スポットの写真を大きく表示する、目印となる建物を強調する、スポット間の距離を考慮した配置にするなど、さらなる改善の余地がある。

その他

・ スタンプ取得状況の確認をより分かりやすくする

・ ARコンテンツ(表示内容)の充実

・ アンケートの回答数を増やすための案内方法の工夫

おわりに

今回のARスタンプラリーは、メンバー全員にとって初めてのことばかりの制作だった。ARやバックエンドの技術はもちろん、サーバの公開、当日の運営まで、分からないことを調べながら一つずつ形にしていく日々だった。

特に難しかったのは、チームで開発を進めることである。担当を分けて作業する中で、実装の進め方や仕様の考え方について意見が食い違うこともあった。それでも、バージョン管理にGitLabを使い、変更の履歴を共有していたため、大きな混乱なく開発を続けることができた。

また、システムの全体像を把握することも簡単ではなかった。フロントエンド、AR、バックエンドをそれぞれ別の担当が作っていたため、自分の担当以外がどう動いているのかを理解するのに時間がかかった。結果として、前述の読み込みエラーのように、全体を通して確認していれば気付けた問題も残った。次に制作する機会があれば、早い段階で全体を通したテストを行い、互いの担当を共有する場を増やしたい。

多くの課題はあったが、2日間の開催を無事に終え、63人もの方にスタンプをコンプリートしていただけたことは、大きな成果だった。アンケートで「楽しかった」という声をいただけたことが、何よりの励みになった。

ARスタンプラリーに参加してくださった皆様、準備や当日の運営を支えてくださった皆様に、改めて感謝申し上げます。 ありがとうございました。

この記事の著者

dmry