{
 "byKey": {
  "cover": [
   {
    "say": "大家好,我是墨大師,歡迎回到這門課。這一章是 Dart 與 Flutter 速成,專門給要做遊戲的你。",
    "item": 0
   },
   {
    "say": "我們不會把整本語言書啃完,只挑球場上真的會碰到的。學完之後,你能看懂 Dart 的變數、類別和非同步,也能說清楚一次點擊怎麼讓畫面重繪。",
    "item": 0
   },
   {
    "say": "最後還會動手做兩個小東西,一個計數器,一個球數裁判。熱身一下,慢熱鴿子,不,是我們自己,準備上場。",
    "item": 0
   }
  ],
  "原理:Dart 與 Flutter 在競技遊戲裡各負責什麼#1": [
   {
    "say": "先說一個大家都經歷過的悲劇。泡麵隊的投手慢熱鴿子站上投手丘,你按下投球按鈕,結果畫面完全沒動。",
    "item": 0
   },
   {
    "say": "你開始懷疑人生,是程式爛,還是手機舊,還是鴿子今天真的很慢熱?我告訴你,八成只是你還沒搞清楚,誰負責什麼。",
    "item": 1
   },
   {
    "say": "做遊戲就像組球隊,投手不用去守游擊,捕手也不用去賣便當。這一章,就是先把 Dart 和 Flutter 的位置站好。",
    "item": 1
   }
  ],
  "原理:Dart 與 Flutter 在競技遊戲裡各負責什麼#2": [
   {
    "say": "先分清楚三個常被混著講的名字:Dart、Flutter 和 Flame。這三個人,位置完全不一樣。",
    "item": 0
   },
   {
    "say": "Dart 是一種程式語言,語法看起來像 Java、C 井字、JavaScript 的混血兒。你寫的每一行邏輯,算分數、判好壞球、排賽程,全都是 Dart。",
    "item": 1
   },
   {
    "say": "Flutter 是 Google 做的跨平台介面工具箱,用 Dart 寫。它負責把畫面長什麼樣,變成手機螢幕上的像素,也負責選單、按鈕、文字輸入和頁面切換。",
    "item": 2
   },
   {
    "say": "Flame 是架在 Flutter 上的遊戲引擎,提供遊戲迴圈、元件樹、碰撞、精靈圖這些遊戲才需要的東西。第三章才會正式登場,現在知道它存在就好。比喻一下:Dart 是你說的語言,Flutter 是整套建材和施工隊,Flame 是房子裡鋪好的球場草皮。草皮再漂亮,承重牆還是要懂。",
    "item": 3
   }
  ],
  "原理:Dart 與 Flutter 在競技遊戲裡各負責什麼#3": [
   {
    "say": "接著看一場遊戲裡的分工圖。請把它想成一棟大樓,由外到內分成四層,我們從最外面開始。",
    "item": 1
   },
   {
    "say": "第一層是 Flutter 外殼,管 App 啟動、主選單、設定頁、商店頁和暫停視窗。第二層是 Flame 遊戲畫布,球場、球員、球、鏡頭、特效都在這裡,而且每秒要更新很多次。",
    "item": 1
   },
   {
    "say": "第三層是純 Dart 規則,好壞球、出局、跑壘、局數,這一層完全不認識畫面。第四層是資料與存檔,玩家資料、設定和戰績都放這裡。",
    "item": 2
   },
   {
    "say": "第一層用到本章大部分的 Flutter 知識:Widget、狀態、頁面切換。第三層和第四層幾乎是純 Dart,所以類別、集合和非同步,才是遊戲的骨幹。",
    "item": 2
   }
  ],
  "原理:Dart 與 Flutter 在競技遊戲裡各負責什麼#4": [
   {
    "say": "這一頁把四層分工再列一次,一層一層對照看。",
    "item": 0
   },
   {
    "say": "第一層 Flutter 外殼,負責 App 啟動、主選單、設定頁、商店頁、暫停視窗。第二層 Flame 遊戲畫布,負責球場、球員、球、鏡頭、特效。",
    "item": 2
   },
   {
    "say": "第三層純 Dart 規則,管好壞球、出局、跑壘、局數,而且完全不認識畫面。這也是本課一再強調的設計原則:規則引擎只說發生了什麼,字幕與畫面由遊戲層去配,兩邊不要糾纏。",
    "item": 3
   }
  ],
  "原理:Dart 與 Flutter 在競技遊戲裡各負責什麼#5": [
   {
    "say": "最後是第四層,資料與存檔,放玩家資料、設定和戰績。",
    "item": 0
   },
   {
    "say": "這一層也幾乎是純 Dart。四層站好位置,球隊才不會打成一團。",
    "item": 1
   }
  ],
  "原理:Dart 與 Flutter 在競技遊戲裡各負責什麼#6": [
   {
    "say": "學程式最浪費時間的事,就是把整本語言書從頭啃到尾。這跟球員不用先背完全部規則書才能上場,是一個道理。",
    "item": 1
   },
   {
    "say": "我們用一個篩選條件:球場上會不會碰到。一定會用的,有變數與型別、final 和 const、函式、類別與物件、List 和 Map,還有 enum。",
    "item": 1
   },
   {
    "say": "常常會用的,是 null safety、繼承與抽象類別、async 和 await,還有 setState。偶爾會用的,是 Stream、泛型、擴充方法和 mixin。先不用管的,是 Isolate 細節、巨集與程式碼生成,還有複雜的套件架構。",
    "item": 2
   },
   {
    "say": "這一章會把一定會用和常常會用講到你能開工,偶爾會用點到為止,先不用管的,就請它在板凳區坐好。",
    "item": 2
   }
  ],
  "原理:Dart 與 Flutter 在競技遊戲裡各負責什麼#7": [
   {
    "say": "這一頁是剛才那張篩選表的條列版。一定會用的,從變數與型別一路到 enum。",
    "item": 1
   },
   {
    "say": "常常會用的,是 null safety、繼承與抽象類別、async 和 await、setState。",
    "item": 2
   },
   {
    "say": "偶爾會用的是 Stream、泛型、擴充方法、mixin。其他的,先放板凳區。",
    "item": 3
   }
  ],
  "觀念教學:Dart 語法重點與類別、物件#1": [
   {
    "say": "想像你的泡麵隊有一位外野手,叫慢熱鴿子,打擊率零點二七五,背號七。你要怎麼把他放進程式裡?",
    "item": 0
   },
   {
    "say": "寫成三個零散的變數?還是寫成一個球員?答案決定你的程式是一支球隊,還是一鍋湯。這一單元把 Dart 最重要的語法走一遍,最後落在類別與物件。",
    "item": 1
   }
  ],
  "觀念教學:Dart 語法重點與類別、物件#2": [
   {
    "say": "先看變數。Dart 是強型別語言,但可以讓編譯器幫你推斷型別。",
    "item": 0
   },
   {
    "say": "比喻一下:var 是可擦的白板,final 是簽了名的表單,簽了就不能改,const 是刻在石碑上的校規,連印刷前都已經決定。",
    "item": 1
   },
   {
    "say": "建議的習慣是,能用 final 就用 final,真的會變才用 var。這能減少誰偷偷改了我的變數這種偵探劇。",
    "item": 2
   },
   {
    "say": "注意 final 和 const 的差別:final 可以在執行期才得到值,例如拿現在的時間,const 必須在編譯期就能確定。Flutter 裡你會看到大量 const Text,意思是這個 Widget 永遠不變,框架可以放心重用它。",
    "item": 3
   }
  ],
  "觀念教學:Dart 語法重點與類別、物件#3": [
   {
    "say": "來看這四行示意程式,請依版本微調。第一行用 var 宣告名字,編譯器推斷成 String,之後可以再指定別的字串。",
    "item": 1
   },
   {
    "say": "第二行 final 加 int,只能指定一次。第三行 const 加 double,是編譯期就確定的常數,這裡是最高速度。",
    "item": 3
   },
   {
    "say": "第四行明確寫出 int 型別,用來記安打數。四種寫法,各有各的用途。",
    "item": 3
   }
  ],
  "觀念教學:Dart 語法重點與類別、物件#4": [
   {
    "say": "最後一行,明確寫型別,宣告一個整數 hits,初始值是零。",
    "item": 0
   },
   {
    "say": "型別寫得清楚,有時候比推斷更好讀,尤其在團隊合作的時候。",
    "item": 1
   }
  ],
  "觀念教學:Dart 語法重點與類別、物件#5": [
   {
    "say": "接著是型別與 null safety。Dart 有健全的 null safety,預設型別不能是 null,想允許空值,要在型別後面加問號。",
    "item": 1
   },
   {
    "say": "這裡有四個符號要記:問號,表示這個值可以是 null;問號加點,表示如果是 null,整段就回傳 null;雙問號,表示如果是 null,就用右邊的備用值;驚嘆號,表示我保證不是 null,錯了就在執行期當機。",
    "item": 2
   },
   {
    "say": "來聽一個踩坑故事。虛構學員小美,在讀存檔的時候,存檔裡沒有暱稱欄位,她用了驚嘆號,結果新玩家一開遊戲就閃退。",
    "item": 2
   },
   {
    "say": "教訓是,驚嘆號是我賭一把。能用雙問號,或先判斷 null,就別用驚嘆號。",
    "item": 2
   }
  ],
  "觀念教學:Dart 語法重點與類別、物件#6": [
   {
    "say": "這是 null safety 的示意程式。第一行,名字是 String,不能是 null。第二行,暱稱是 String 加問號,可以是 null,預設就是 null。",
    "item": 1
   },
   {
    "say": "第三行用問號加點取長度,暱稱如果是 null,整段就回傳 null,不會當機。",
    "item": 3
   }
  ],
  "觀念教學:Dart 語法重點與類別、物件#7": [
   {
    "say": "第四行用雙問號,暱稱是 null 的時候,顯示無暱稱當備用值。這是最安全、最好讀的寫法。",
    "item": 1
   },
   {
    "say": "第五行用驚嘆號,等於跟編譯器說,相信我,它不是 null。如果猜錯,執行期就當機。這個賭,別隨便下注。",
    "item": 2
   }
  ],
  "觀念教學:非同步 Future、async、await 與 Stream#1": [
   {
    "say": "你在拉麵店點了一碗麵,老闆說十分鐘後好。你不會站在櫃檯前盯著鍋子十分鐘,而是回座位滑手機。",
    "item": 0
   },
   {
    "say": "等麵好了,老闆喊你的號碼,你再去取。非同步程式,就是這麼回事:告訴系統做完再通知我,然後繼續做別的事。",
    "item": 1
   },
   {
    "say": "遊戲裡這很重要,因為你不能讓畫面在讀存檔的時候凍結,害玩家以為鴿子睡著了。",
    "item": 1
   }
  ],
  "觀念教學:非同步 Future、async、await 與 Stream#2": [
   {
    "say": "Dart 的主程式,稱為一個 isolate,一次只做一件事。但它有一個事件迴圈,把事情排隊處理。",
    "item": 0
   },
   {
    "say": "點擊、計時器、檔案讀取完成、網路回應,輪流來。所以如果你用同步的方式,等一件很慢的事,後面的事就全部排隊,畫面當然卡住。",
    "item": 1
   },
   {
    "say": "在這個模型裡,await 不是讓整個程式停下來,而是這個函式先離場,等結果到了再回來接著做,期間其他事件照常處理。",
    "item": 2
   }
  ],
  "觀念教學:非同步 Future、async、await 與 Stream#3": [
   {
    "say": "看事件佇列示意圖。第一個是點擊按鈕,排在最前面。",
    "item": 1
   },
   {
    "say": "接著繪製下一幀,然後是存檔讀取完成,最後是計時器到點,後面還有很多事件等著。",
    "item": 2
   },
   {
    "say": "它們一個一個輪流處理。所以 await 的時候,函式離場,佇列照樣往前走,畫面不會卡。",
    "item": 2
   }
  ],
  "觀念教學:非同步 Future、async、await 與 Stream#4": [
   {
    "say": "Future 代表未來某一刻會得到的值,就像一張取餐單。下面這段是示意程式,請依版本微調。",
    "item": 0
   },
   {
    "say": "loadSave 函式裡,先 await 一個延遲一秒,假裝讀檔,然後回傳存檔讀取完成。",
    "item": 2
   },
   {
    "say": "main 函式裡,先印一,開始,再 await loadSave,拿到結果,印二,最後印三,結束。",
    "item": 3
   },
   {
    "say": "所以輸出順序是一、二、三,每一行都等前一行完成。",
    "item": 4
   },
   {
    "say": "如果不加 await,loadSave 只會回傳一個還沒完成的 Future,後面的程式會先往下走。這就是常見的亂序小劇場。",
    "item": 4
   }
  ],
  "觀念教學:非同步 Future、async、await 與 Stream#5": [
   {
    "say": "我們把這段程式拆開看。第一個函式 loadSave,回傳型別是 Future 加 String,而且標了 async。",
    "item": 1
   },
   {
    "say": "裡面 await 一秒鐘的延遲,再回傳字串。",
    "item": 2
   },
   {
    "say": "第二個函式 main,回傳 Future 加 void,同樣標了 async,這樣裡面才能用 await。",
    "item": 3
   }
  ],
  "觀念教學:非同步 Future、async、await 與 Stream#6": [
   {
    "say": "兩個函式的結尾大括號,就是這一頁的收尾。",
    "item": 0
   },
   {
    "say": "重點是,每個 await 都只讓所在的函式暫停,不是整個 App。",
    "item": 1
   }
  ],
  "觀念教學:非同步 Future、async、await 與 Stream#7": [
   {
    "say": "async 和 await,是讓非同步看起來像一般程式的語法糖。",
    "item": 0
   },
   {
    "say": "函式簽名加上 async,回傳型別要包在 Future 裡。在 async 函式裡,可以用 await 等待 Future 的結果。",
    "item": 2
   },
   {
    "say": "你也可以用 then 的寫法,但 await 通常更好讀。錯誤處理跟一般程式一樣,用 try 和 catch。",
    "item": 3
   },
   {
    "say": "示意程式裡,try 區塊 await 讀檔並印出結果,出錯就在 catch 印出讀檔失敗。請依版本微調。",
    "item": 3
   }
  ],
  "觀念教學:Widget、狀態與重繪#1": [
   {
    "say": "在 Flutter 的世界裡,萬物皆 Widget。文字是 Widget,按鈕是 Widget,置中是 Widget,留白也是 Widget,連整個 App 都是 Widget。",
    "item": 0
   },
   {
    "say": "剛開始你會覺得誇張,我只是想把一個數字放在螢幕正中間,為什麼要包三層?放心,這像俄羅斯娃娃,每一層只做一件事,拆開看一點也不難。",
    "item": 1
   }
  ],
  "觀念教學:Widget、狀態與重繪#2": [
   {
    "say": "Widget 不是真正的畫面元件,而是一份輕量、不可變的描述。",
    "item": 0
   },
   {
    "say": "例如,這裡要一個文字,內容是五,字大四十八。框架拿著這份描述,去建立與更新真正繪製的東西。",
    "item": 1
   },
   {
    "say": "重點是,Widget 很便宜,可以大量建立,丟掉也不心疼。比喻一下,Widget 像餐廳的菜單,上面寫牛肉麵一碗,真正端上桌的麵是另一回事。菜單可以隨時重印,桌上的麵不用每次重煮。",
    "item": 2
   }
  ],
  "觀念教學:Widget、狀態與重繪#3": [
   {
    "say": "來看 Widget 樹。最外面是 MaterialApp,它的下面是 Scaffold。",
    "item": 1
   },
   {
    "say": "Scaffold 底下有 AppBar,AppBar 裡面放著標題文字。另外還有 body,是一個 Center,裡面放著一個 Text,顯示零。底下還有一顆 FloatingActionButton。",
    "item": 3
   },
   {
    "say": "每個 Widget 都有子節點,整體構成一棵樹。",
    "item": 3
   },
   {
    "say": "這張圖很適合想成動畫:一個點擊發生,哪些節點會被重新建立。講義後面會用實際的 log 一步步印證。",
    "item": 3
   }
  ],
  "觀念教學:Widget、狀態與重繪#4": [
   {
    "say": "Widget 分兩種:StatelessWidget 和 StatefulWidget。差別在於,會變,還是不會變。",
    "item": 0
   },
   {
    "say": "StatelessWidget 沒有會變的內部資料,只靠傳進來的參數,例如固定的標題。",
    "item": 1
   },
   {
    "say": "StatefulWidget 有會變的內部資料,也就是狀態,例如計數器的數字。",
    "item": 2
   },
   {
    "say": "StatefulWidget 的寫法是兩個類別:一個 Widget 加一個 State,資料放在 State 裡。第一次看會覺得囉嗦,但這是為了讓 Widget 本身保持輕量不可變,把會變的資料放在長壽的 State 裡。",
    "item": 2
   }
  ],
  "觀念教學:Widget、狀態與重繪#5": [
   {
    "say": "這是計數器的示意程式,請依版本微調。第一個類別 Counter,繼承 StatefulWidget,有一個 createState 方法。",
    "item": 1
   },
   {
    "say": "createState 回傳另一個類別,底線 CounterState。第二個類別繼承 State,裡面有一個整數 底線 count,初始值是零,這就是狀態。",
    "item": 3
   },
   {
    "say": "最後 build 方法回傳一個 Text,顯示目前的 count。畫面等於 build 狀態,這就是宣告式的核心。",
    "item": 3
   }
  ],
  "觀念教學:Widget、狀態與重繪#6": [
   {
    "say": "最後的大括號,把 State 類別收尾。",
    "item": 0
   },
   {
    "say": "記住,資料放在 State 裡面,Widget 本身一直保持輕量不可變。",
    "item": 1
   }
  ],
  "觀念教學:Widget、狀態與重繪#7": [
   {
    "say": "那什麼是狀態?狀態就是改了它,畫面應該跟著不同的資料。",
    "item": 0
   },
   {
    "say": "例如目前分數、球數、選單是否展開、使用者輸入。不是所有變數都是狀態,一個只在函式裡算一下就丟掉的暫時變數,就不是。",
    "item": 1
   },
   {
    "say": "給你一個判斷口訣:如果它改變了,使用者應該看到不同的畫面,那它就是狀態。",
    "item": 2
   }
  ],
  "課後重點整理:Dart 與 Flutter 速成#1": [
   {
    "say": "這一章你把 Dart 與 Flutter 的重點過了一遍:語言基本功、類別與物件、非同步、Widget 與重繪。",
    "item": 0
   },
   {
    "say": "你還親手做了計數器和球數裁判。慢熱鴿子終於熱身完畢,下一章就要進入 Flame 的球場。",
    "item": 1
   }
  ],
  "課後重點整理:Dart 與 Flutter 速成#2": [
   {
    "say": "先看本章的地圖,還是那四層分工。",
    "item": 0
   },
   {
    "say": "第一層 Flutter 外殼,管選單、設定、商店、暫停視窗和 H U D 數字。第二層 Flame 遊戲畫布,管球場、球員、球、鏡頭、特效。",
    "item": 2
   },
   {
    "say": "第三層純 Dart 規則,管好壞球、出局、跑壘、局數。這張地圖,請放在腦袋最顯眼的位置。",
    "item": 3
   }
  ],
  "課後重點整理:Dart 與 Flutter 速成#3": [
   {
    "say": "第四層是資料與存檔,放玩家資料、設定和戰績。",
    "item": 0
   },
   {
    "say": "四層各司其職,以後出問題,先問這是哪一層的事。",
    "item": 1
   }
  ],
  "課後重點整理:Dart 與 Flutter 速成#4": [
   {
    "say": "來複習必記重點,一共十五條,分四頁。",
    "item": 0
   },
   {
    "say": "第一條,Dart 是語言,Flutter 是介面工具箱,Flame 是建在 Flutter 上的遊戲引擎。第二條,畫面等於 build 狀態,這是宣告式的核心。",
    "item": 2
   },
   {
    "say": "第三條,var 可以重新指定,final 只能指定一次,const 是編譯期常數。",
    "item": 3
   },
   {
    "say": "第四條,null safety:型別預設不可為 null,用問號、問號點、雙問號處理,謹慎使用驚嘆號。",
    "item": 4
   },
   {
    "say": "第五條,具名參數搭配 required,讓呼叫的地方清楚好讀。",
    "item": 5
   }
  ],
  "課後重點整理:Dart 與 Flutter 速成#5": [
   {
    "say": "第六條,enum 取代數字代碼,類別建模球員與球隊,不可變物件搭配 copyWith。",
    "item": 1
   },
   {
    "say": "第七條,單執行緒加事件迴圈,await 只讓這個函式暫停,不會凍結畫面。",
    "item": 2
   },
   {
    "say": "第八條,Future 給一個結果,Stream 給一串結果,Future.wait 同時等,取最慢者。用講義的示範數字來看,兩個獨立讀取分別要一秒和兩秒,依序等約三秒,同時等只要約兩秒。",
    "item": 3
   },
   {
    "say": "第九條,Timer 要記得 cancel,await 之後,在 setState 前要檢查 mounted。",
    "item": 4
   }
  ],
  "課後重點整理:Dart 與 Flutter 速成#6": [
   {
    "say": "第十條,StatelessWidget 沒有內部狀態,StatefulWidget 把會變的資料放在 State。",
    "item": 1
   },
   {
    "say": "第十一條,重繪七步:第一,點擊。第二,onPressed 被呼叫。第三,setState 標記需要重建。",
    "item": 2
   },
   {
    "say": "第四,下一幀框架呼叫 build。第五,build 回傳新的描述。第六,比對差異。第七,更新畫面。這是本章最重要的流程圖。",
    "item": 2
   },
   {
    "say": "第十二條,build 次數等於一加點擊次數,每次點擊一個 setState,與每次加多少無關。第十三條,縮小 setState 的範圍,拆小 Widget,善用 const。",
    "item": 4
   },
   {
    "say": "第十四條,規則引擎回傳事件,不回傳文字,字幕與畫面由遊戲層去配。",
    "item": 5
   }
  ],
  "課後重點整理:Dart 與 Flutter 速成#7": [
   {
    "say": "最後一條,第十五條。遊戲每一幀的更新,不用 setState,也不用 Future.delayed,而是遊戲迴圈。",
    "item": 0
   },
   {
    "say": "這條會在下一章的 Flame 一整章展開,先記住這句話就好。",
    "item": 1
   }
  ],
  "closing": [
   {
    "say": "好,本章到這裡。慢熱鴿子熱身完畢,你也是。",
    "item": 0
   },
   {
    "say": "接下來請完成實作,再做章末小測驗,檢查自己學會了多少。答錯也別氣餒,連大聯盟打擊王都會被三振。我們下一章見。",
    "item": 1
   }
  ]
 }
}