攝靈者卡牌 iOS

宣傳網站

攝靈者卡牌宣傳網站 已放在本 repo 的 promo-site/ 目錄，可直接開啟預覽。

攝靈者卡牌是一款 iOS AI 實拍卡牌對戰遊戲。玩家用 iPhone 拍下現實物件後，AI 會分析形象、屬性與技能，生成可收藏的怪獸卡牌；再編成主將與副將，進入魔法競技場展開回合對戰。

核心特色：

• 拍照抓怪：使用相機或照片，將桌上的小物變成卡面角色。
• 去背召喚：保留物件輪廓，讓卡牌美術更像真正被召喚出場。
• 雙卡編成：主將與副將搭配，讓每次戰鬥有不同節奏。
• 回合決鬥：每回合選擇攻擊、防禦、技能或換上副將，靠屬性與冷卻節奏打出勝利。

攝靈者卡牌是一個 iOS Workshop 範例專案。玩家可以拍照或選取照片，交給 AI 分析後生成怪獸卡牌，再進入對戰。

Repository: https://github.com/hedula/snap-fighter-ios.git

教材下載

建議學員使用以下任一方式取得專案：

git clone https://github.com/hedula/snap-fighter-ios.git
cd snap-fighter-ios

如果不使用 Git，也可以直接在 GitHub 頁面點選 Code -> Download ZIP 下載。

環境需求

• macOS
• Xcode 26 以上
• iOS 17.0 以上模擬器或實機
• Swift 5

已驗證的專案設定：

• iOS Deployment Target: 17.0
• Swift Version: 5.0
• App target: Snap Fighter

如何開啟專案

1. 使用 Xcode 開啟 Snap Fighter.xcodeproj
2. 選擇 Snap Fighter target
3. 選擇 iPhone 模擬器或實機
4. 按下 Run

Workshop 建議操作流程

這個 repo 目前可直接作為教材入口使用，因為 app 已內建預設分析端點：

• 預設 API endpoint: https://snap-fighter-ai.hedula.workers.dev/analyze
• app 啟動後可先使用「快速開戰」直接試玩
• 也可使用「拍照抓怪」或「使用照片」進行 AI 分析

如果課堂時間有限，建議先讓學員完成：

1. 開啟專案並成功執行 app
2. 使用「快速開戰」熟悉流程
3. 再進入拍照抓怪與卡牌對戰

AI 分析與 Worker 設定

app 會從 Info.plist build setting WORKER_ANALYZE_ENDPOINT 讀取 API 位址；目前專案已設定預設值。

app 也會從 Info.plist build setting AI_PROVIDER 決定分析模式：

• auto: 預設值。若 Apple Foundation Models 可用，優先使用本機模型；否則使用 Worker。
• apple-local: 強制使用 Apple Foundation Models + Vision。需要支援 Apple Intelligence 的裝置與系統版本。
• worker: 強制使用 Cloudflare Worker。
• mock: 使用本機假資料，適合教學排除網路問題。

Debug build 可加入 launch argument --show-ai-debug-overlay，畫面右上角會顯示目前 AI_PROVIDER 模式，以及分析完成後實際使用的 provider/model。

教學或測試時，也可以用 launch argument 暫時覆蓋 provider，不需要改 Build Settings：

--ai-provider=mock
--ai-provider=worker
--ai-provider=apple-local
--ai-provider=auto

如果你要改成自己的 Worker：

1. 先部署 worker
2. 將部署後的 /analyze URL 設定到 Xcode build setting INFOPLIST_KEY_WORKER_ANALYZE_ENDPOINT

Worker 詳細部署方式請見 worker/README.md

專案結構

• Snap Fighter: iOS app
• worker: Cloudflare Worker API
• Snap FighterTests: 單元測試
• Snap FighterUITests: UI 測試

備註

這個 repo 目前只有一份主專案，尚未另外拆分為 starter 與 completed 兩個版本。若主辦單位明確要求「範例專案」與「完成版專案」分開提供，建議後續再補兩份分支或資料夾版本。