PAIA Desktop 是什麼？
PAIA Desktop 是 帕亞科技 所開發的一套軟體，讓使用者在自己的電腦上，使用程式積木來開發遊戲 AI。PAIA Desktop 中會包含數個精心製作的遊戲，每個遊戲都有各自的玩法，玩家需要思考遊戲的破關策略，並使用程式積木來蒐集資料、訓練模型、測試模型，產生各個遊戲 AI，趕快來使用看看，一起訓練自己的遊戲 AI。
和 Scratch 不同的是，PAIA Desktop 中的程式積木會轉換成 python 程式碼，並使用內建的 python 環境執行，像是訓練和測試的程式，實際上都是轉換成 python 程式碼 才能在電腦上運作，因此我們若要進行競賽，需要上傳的也是 python 程式碼和模型檔案，這部份會在之後的單元詳細說明。
如何安裝 PAIA Desktop？
首先我們先進到 https://app.paia-arena.com/ 的網站，點擊右上角「下載桌面版」的按鈕，會開啟一個彈跳視窗，就會顯示 Windows 跟 macOS 兩種作業系統的安裝程式，請大家依照自己電腦的作業環境進行選擇！
在 Windows 作業系統安裝 PAIA Desktop
點擊按鈕下載安裝執行檔
下載完畢後直接把這個檔案點開！系統就會幫你安裝到你的電腦中，安裝時會出現這樣的畫面：
安裝完後應用程式的視窗會跳出來，就可以開始使用啦！
若點擊 exe 安裝檔後電腦沒有順利進入安裝流程，請見〈常見問題〉單元。
在 macOS 作業系統安裝 PAIA Desktop
點擊按鈕下載 dmg 安裝檔
📝 電腦是 Windows 10/11 作業系統，請選擇 Windows 64-bit 版本。
電腦是蘋果電腦，需依照 CPU 型號選擇不同版本：若 CPU 為 Apple Silicon M 系列（如：M1, M2），請下載 macOS 64-bit arm64 版本；若 CPU 為 Intel Core 系列，請下載 macOS 64-bit x64 版本。
將檔案儲存至「下載項目」資料夾中！
到「下載項目」的資料夾當中，點選兩下進行安裝。
看到下圖的畫面，請依照圖示將 PAIA Desktop 拖曳到資料夾中。
到應用程式的搜尋頁面，找到 PAIA Desktop 應用程式，即可打開。
第一次接觸
打開 PAIA Desktop 即可看到主頁面，包含 【遊戲AI】、【程式解題】、【自由編輯】等三個區塊。【遊戲AI】包含多款遊戲，也是PAIA最主要的服務，【程式解題】提供多道題目，讓使用者可以熟悉積木，也可以練習運算思維，【自由編輯】則是讓使用者可以自行出題，你也可以在此隨時驗證自己的邏輯想法。
目前共有九款遊戲皆可免費使用、遊玩，115 年度正式賽使用「魷來魷去-對戰版」遊戲、表演賽使用「定向越野大作戰」遊戲。
登入帳號
PAIA Desktop 的遊戲需要登入才可以使用，尚未登入的使用者，右上角會顯示 未登入 的灰色貓頭鷹按鈕。
點擊 貓頭鷹，並選擇 一般登入 開啟 https://app.paia-arena.com/ 登入頁面
在登入頁面，選擇 Google 帳號 或 教育雲端帳號（open ID） 登入，兩種擇一即可。
📝 如果你是國中小在學的學生或老師，建議使用教育雲端帳號（Open ID）登入，即日起到 116/6/30 都能免費使用喔！
📝 若登入後桌面軟體仍顯示尚未登入，請重新開啟桌面版軟體，再次點選登入，即會自動跳轉
登入後，在個人圖示右側，點擊『我的遊戲』可以查看目前能夠執行的遊戲。
開啟專案
PAIA Desktop 是開發遊戲 AI 的工具，當我們要開發時，需要以 專案 為單位，一個 專案 只能開發一個遊戲的 AI。
我們也可以針對同一個遊戲，建立不同的 遊戲 AI 專案。
這裡我們將以 「魷來魷去-對戰版」 遊戲為例，示範如何建立專案、開啟專案。
如圖，中間上方寫了「1.7.2」，這個是遊戲的版本。初次使用時先點選下載。
下方的「載入最近專案」顯示的是最近開啟過的 AI 專案，這樣重開軟體時就不用再去找自己的專案位置了！
點選中間有一個「新增專案」按鈕，就能夠創建一個全新的專案出來！
📝 專案名稱命名建議：
- 可讀性：可以一眼就看得出是什麼檔案
- 一致性：採用一致的命名方式，比如用編號：
arkanoid_01 、 arkanoid_02 ，或是用日期： arkanoid_1030 、 arkanoid_1031
遊戲AI開發介面
專案畫面介紹
下圖是專案編輯的界面，我們將會介紹各個區塊。
上方四個小框框，分別是蒐集、訓練、測試跟未分類，也能依需求新增更多檔案。當我們建立了一個新的專案後，我們的的檔案也會分成這四份儲存。
點開畫面右上「資料夾圖示」後，可以得知目前的 AI 專案的檔案內容。
右下圖示可以開啟遊戲介紹，遊戲介紹包含遊戲規則與更動內容，可以根據規則理解如何達成遊戲的過關條件。
右下圖示可以開啟訊息視窗（Console），訊息視窗會顯示遊戲過程的狀態、程式輸出的文字，或是程式的 error 也會顯示在這裡。
右下圖示可以開啟遊戲參數設定，這裡可以設定每秒顯示張數（FPS）、玩家人數、設定關卡等等。
左邊程式積木區：進入操作介面後，可以看到左邊有一排積木，依照不同的功能進行分類。我們要使用某個積木時，只要將那個積木拖曳到白色編輯區就可以使用啦！
執行遊戲
點擊畫面的右下角的播放按鈕，便可以執行遊戲！
可以切換執行的積木，再次點擊播放按鈕，若是有遊戲積木就會啟動遊戲，若是沒有遊戲積木（像是訓練資料夾中的範例程式），則不會進行遊戲，而是執行 python 程式。
指派 AI 參與競賽
點擊右上角圖示即可將 AI 指派至競賽，如果還沒有加入競賽需要先在 PAIA 平台中加入自動競賽。
參加競賽環節可參考PAIA平臺教學，或是輸入競賽代碼參賽。
選擇要進行 AI 指派的競賽後，點擊下一步。
輸入 AI 名稱、AI 說明、選擇上傳檔案後就可以進行指派。如果找不到 ml_play.py 代表還未曾另存 Python 檔案；如果找不到 pickle 檔案代表沒有成功訓練過 AI
積木操作小技巧
跳轉至函式定義的方法
假如我們已經有定義一個函式如下
在其他地方呼叫或使用這個函式時，點擊 查看函式定義 就能夠跳轉。
另存積木圖片
右鍵完成的積木區塊，選 複製圖片，即可複製無背景圖片。
選 儲存圖片，可將積木圖片另存至指定位置。
在空白處右鍵 複製圖片 或 儲存圖片，可複製或另存整個頁面積木圖片。
新增、刪除積木檔案
對上方蒐集、訓練、測試、未分類四類別中，希望新增積木檔案的部分點選右邊的倒三角。
點擊 + 號即可新增積木檔案。
若要刪除則選擇旁邊的 X 並確定號即可。
檔案管理與設定
開啟專案資料夾、存檔、載入
在檔案清單中點選「開啟專案位置」，開啟專案資料夾。
載入之前編輯的專案：當我們想要編輯之前的專案時，點進遊戲時就會看到最近編輯的專案。也可以透過加號尋找你的專案位置，就可以載入之前的專案啦！
設定調整語言、位置
選擇上方選單的設定。
可以調整語言與專案預設路徑。
各式各樣小工具
對戰工具
右下圖示可以開啟對戰工具，透過對戰工具可以使用一或多個 AI 進行遊戲對戰，能夠勾選 使用當前檔案 預設選手 1 為目前在 Desktop 中開發的 AI 檔案。
請注意：需要是能夠對戰的遊戲（例如：魷來魷去對戰版）才可以多於一個 AI 進行對戰。
Python 語法編輯器
在任意積木檔案，點選 『Ctrl＋P』 或 『Cmd＋P』，即可進入python 模式，再次點選『以Python編輯』即可進入Python文字編輯器，原本的積木檔案依舊會保留，可以隨時切換。
常見問題
Q：如果點擊 exe 安裝檔，電腦沒有順利進入安裝流程，怎麼辦？
解決方法：請嘗試在 exe 檔上點擊右鍵，點選「疑難排解相容性」的選項，依據系統指示執行。
Q：為什麼要有 PAIA Desktop 呢？
PAIA Desktop 可以讓我們用積木的方式來視覺化複雜且不易理解的程式碼！
Q：PAIA Desktop 還可以用來作哪些事情？
- PAIA Desktop 還可以讓我們使用積木撰寫 python！
- 在本機訓練並測試自己的遊戲 AI 模型。
Q：一定要有網路才能使用嗎？
登入時需要有網路，但如果是專案編輯的部分，離線時仍然可以使用喔！
Q：要如何更新 PAIA Desktop？
目前只要 PAIA Desktop 有更新，將會在背景自動更新，你可以不用煩惱這件事情喔。