{
 "byKey": {
  "cover": [
   {
    "say": "大家好,我是墨大師,歡迎回到這門課。",
    "item": 0
   },
   {
    "say": "這一章我們要讓畫面上出現第一顆會自己跑、碰到牆還會彈回來的球,它就是整門課的第一顆棒球。",
    "item": 0
   }
  ],
  "原理:Flame 是什麼,遊戲迴圈為什麼是遊戲的心跳#1": [
   {
    "say": "先講一個新手常見的想法:在按鈕的 onPressed 裡把球的位置加十,再呼叫 setState,不就動了嗎?",
    "item": 0
   },
   {
    "say": "結果按一下,球跳十格;按十下,球跳一百格。這不叫動畫,這叫瞬間移動的魔術秀。",
    "item": 1
   },
   {
    "say": "球飛不出去,不是你手殘,是你還沒給遊戲一顆會自己跳的心臟。",
    "item": 1
   },
   {
    "say": "這顆心臟,就叫遊戲迴圈,英文是 game loop。這一章的目標很單純:球自己跑,碰牆彈回來,不需要任何人點任何東西。",
    "item": 2
   },
   {
    "say": "接下來十幾章的投球、打擊、飛行、全壘打,全部都建在它的脈搏上。",
    "item": 2
   }
  ],
  "原理:Flame 是什麼,遊戲迴圈為什麼是遊戲的心跳#2": [
   {
    "say": "先認識 Flame。Flutter 是 Google 的跨平台 U I 工具包,用 Dart 寫一次,就能跑在 Android、iOS 等平台。",
    "item": 0
   },
   {
    "say": "Flame 是 Flutter 社群維護的 2D 遊戲引擎套件。關鍵字是套件,它不是另一個平台,你的專案還是 Flutter 專案,只是多裝了一個叫 flame 的套件。",
    "item": 0
   },
   {
    "say": "打個比方,Flutter 是設備齊全的廚房,Flame 是你另外買的一套開餐廳專用工具。第一項是遊戲迴圈,自動每一幀呼叫你的更新與繪製,還告訴你經過了多少時間。",
    "item": 1
   },
   {
    "say": "第二項是元件系統,把球、球員、記分板都做成元件,掛成一棵樹,由引擎代為更新與繪製。",
    "item": 2
   },
   {
    "say": "第三項是座標、向量與相機,像 Vector2 這種好用的二維向量,還有管理畫面看哪裡的相機。",
    "item": 3
   }
  ],
  "原理:Flame 是什麼,遊戲迴圈為什麼是遊戲的心跳#3": [
   {
    "say": "Flame 還準備了輸入、碰撞、音效和精靈動畫,這些要到後面的章節才會用到,現在先知道它們存在就好。",
    "item": 1
   },
   {
    "say": "也要老實說,Flame 不是 3D 引擎,也不是會自動幫你做棒球規則的魔法。規則、物理、平衡,還是你和我在後面章節親手做。",
    "item": 1
   }
  ],
  "原理:Flame 是什麼,遊戲迴圈為什麼是遊戲的心跳#4": [
   {
    "say": "為什麼遊戲要換一套畫法?因為一般 App 是事件驅動:使用者點一下,程式才動一下,畫面變了就 setState 重畫。沒人碰手機時,App 安靜得像圖書館。",
    "item": 1
   },
   {
    "say": "遊戲不一樣。就算你雙手離開螢幕,球還在飛、對手還在投、時間還在走。",
    "item": 2
   },
   {
    "say": "遊戲是時間驅動,不管有沒有人操作,世界每秒都要往前走幾十次。所以遊戲需要一個不斷轉動的迴圈,而不是乖乖等事件。",
    "item": 2
   }
  ],
  "原理:Flame 是什麼,遊戲迴圈為什麼是遊戲的心跳#5": [
   {
    "say": "遊戲迴圈的偽代碼只有幾行,意思是重複直到遊戲結束,每一圈做四件事。",
    "item": 0
   },
   {
    "say": "第一,取得這一幀經過的時間 dt。",
    "item": 1
   },
   {
    "say": "第二,讀取輸入,看看玩家點了哪裡。第三,更新世界,依 dt 移動每個東西、判定碰撞、改分數。",
    "item": 3
   },
   {
    "say": "第四,繪製世界,把每個東西畫到螢幕上。",
    "item": 4
   },
   {
    "say": "在 Flutter 上,系統每次要刷新螢幕就通知一聲,Flame 接住通知,把這四步串起來。你只要記得:更新放在 update,繪製放在 render。",
    "item": 4
   },
   {
    "say": "螢幕多數是六十赫茲,也就是一秒六十幀,每幀約十六點七毫秒;有些手機是九十或一百二十赫茲,一幀只有八點三毫秒。這點很重要,後面的 dt 單元會專門處理。",
    "item": 4
   }
  ],
  "原理:Flame 是什麼,遊戲迴圈為什麼是遊戲的心跳#6": [
   {
    "say": "把剛才的偽代碼看成一個公式:重複直到遊戲結束。",
    "item": 0
   },
   {
    "say": "結束條件之前,這四步會一圈又一圈地轉。就像棒球比賽,不打完九局不收工,只是我們這一局是每秒轉六十圈。",
    "item": 1
   }
  ],
  "原理:Flame 是什麼,遊戲迴圈為什麼是遊戲的心跳#7": [
   {
    "say": "再看一個畫面的一生,也就是一幀的旅程。",
    "item": 0
   },
   {
    "say": "起點是系統喊一聲:螢幕要刷新了!",
    "item": 1
   },
   {
    "say": "接著 Flame 算出 dt,例如零點零一六七秒;然後 update 讓球的位置加上速度乘以 dt;再來 render 在新位置畫一顆圓。",
    "item": 2
   },
   {
    "say": "畫面送到螢幕,十六點七毫秒後再來一次。",
    "item": 2
   },
   {
    "say": "這張圖很適合畫成圓圈流程圖,四個節點首尾相連,中間寫著約每秒六十圈。",
    "item": 3
   },
   {
    "say": "記住它,這一章所有東西都在這個圈裡。每一幀都從系統那一聲刷新開始。",
    "item": 4
   }
  ],
  "觀念教學:update 與 render,一圈迴圈做兩件事#1": [
   {
    "say": "接下來看 update 與 render。有一位廚師,工作是把食材煮熟;另一位擺盤師,工作是把煮好的菜放到盤子上。",
    "item": 1
   },
   {
    "say": "如果廚師一邊煮一邊擺盤,常常煮到一半就把半生的肉端出去;如果擺盤師一邊擺一邊偷偷加鹽,味道每次都不一樣。",
    "item": 1
   },
   {
    "say": "Flame 的 update 和 render 就是這兩位。update 負責算:球在哪、速度多少、有沒有碰牆。render 負責畫:照算好的結果在畫布上畫圓。",
    "item": 2
   },
   {
    "say": "兩者分開,是遊戲程式最重要的紀律之一,也是第六章規則引擎與畫面分離的小預告。",
    "item": 2
   }
  ],
  "觀念教學:update 與 render,一圈迴圈做兩件事#2": [
   {
    "say": "來看最小的 Flame 程式長什麼樣。先聲明,這是示意程式,請依你安裝的 Flutter 與 Flame 版本微調。",
    "item": 1
   },
   {
    "say": "main 裡只做一件事:runApp 一個 GameWidget,把 BounceGame 放進去。",
    "item": 2
   },
   {
    "say": "遊戲類別裡覆寫 onLoad,先呼叫 super 的 onLoad,再 add 一顆 Ball。",
    "item": 3
   },
   {
    "say": "重點有三個。第一,GameWidget 把遊戲嵌進 Flutter 畫面,所以遊戲其實是 Flutter 畫面裡的一個區塊。",
    "item": 4
   },
   {
    "say": "第二,FlameGame 是遊戲的根,它自己就是元件樹的根。第三,onLoad 在遊戲載入時只執行一次,適合放初始化與 add 元件。",
    "item": 4
   }
  ],
  "觀念教學:update 與 render,一圈迴圈做兩件事#3": [
   {
    "say": "這是程式的上半段,一樣是示意程式。",
    "item": 0
   },
   {
    "say": "開頭先 import 三個套件:flame 的 components、flame 的 game,還有 Flutter 的 material。",
    "item": 3
   },
   {
    "say": "接著是 main 函式,等一下會在裡面呼叫 runApp。",
    "item": 4
   }
  ],
  "觀念教學:update 與 render,一圈迴圈做兩件事#4": [
   {
    "say": "下半段先把 main 的收尾補上。",
    "item": 0
   },
   {
    "say": "再來宣告 BounceGame 這個類別,繼承 FlameGame。",
    "item": 2
   },
   {
    "say": "類別裡面放 onLoad 與初始化,大括號收好,一個最小的遊戲就完成了。",
    "item": 3
   }
  ],
  "觀念教學:update 與 render,一圈迴圈做兩件事#5": [
   {
    "say": "先看 update。每一幀,Flame 會對遊戲和所有子元件呼叫 update,傳進來的 dt 單位是秒,型別是 double,例如零點零一六七。",
    "item": 1
   },
   {
    "say": "這段程式做兩件事:先呼叫 super 的 update,再讓 position 加上 velocity 乘以 dt。",
    "item": 2
   },
   {
    "say": "規則一,永遠先呼叫 super 的 update。這一行會讓子元件也跟著更新,漏掉的話,整棵子樹會像被點穴一樣站著不動。",
    "item": 3
   },
   {
    "say": "規則二,update 裡只做狀態的事,不要在這裡畫圖,也不要彈對話框、不要等網路。",
    "item": 3
   }
  ],
  "觀念教學:update 與 render,一圈迴圈做兩件事#6": [
   {
    "say": "這是 update 的程式寫法,一樣是示意。",
    "item": 0
   },
   {
    "say": "標上 override,函式名稱是 update,參數是 double 的 dt。",
    "item": 2
   },
   {
    "say": "函式主體就是剛才那兩行,收尾的大括號別忘了。",
    "item": 3
   }
  ],
  "觀念教學:update 與 render,一圈迴圈做兩件事#7": [
   {
    "say": "再看 render。更新完,Flame 對每個元件呼叫 render,傳進來一塊 Canvas,就是 Flutter 的畫布,可以畫圓、畫矩形、畫線、畫文字。",
    "item": 1
   },
   {
    "say": "這段程式做兩件事:先呼叫 super 的 render,再用 drawCircle 在元件中心畫一個白色的圓,半徑是寬度的一半。",
    "item": 2
   },
   {
    "say": "規則是 render 裡不要改遊戲狀態。理由很實際:render 的呼叫次數與時機不見得跟 update 一一對應,你偷偷把球往前推一步,將來調整畫面更新率,球速就會莫名其妙變掉。",
    "item": 3
   },
   {
    "say": "還有一個小訣竅:Paint 物件最好存成成員變數,別每一幀都新建,否則垃圾回收會偷偷拖慢你。上面的示意為了精簡才寫在 render 裡,實作單元會改成成員變數。",
    "item": 3
   }
  ],
  "觀念教學:元件樹與專案結構,把遊戲排成一棵樹#1": [
   {
    "say": "想像一支虛構的泡麵隊:隊上有教練、投手群、野手群,野手群裡再分內野手、外野手,每個人手上還有手套。",
    "item": 1
   },
   {
    "say": "這是一棵樹:根是球隊,往下分枝,最後是葉子。遊戲元件也是這樣排的。",
    "item": 1
   },
   {
    "say": "Flame 把整個遊戲排成一棵元件樹,英文是 component tree。根是 FlameGame,球場、球、記分板、球員都是它的子孫。",
    "item": 2
   },
   {
    "say": "引擎每一幀只要從根出發往下巡一遍,就能讓所有元件都 update、都 render。這就是為什麼你只要 add 一顆球,球就會自己動、自己被畫。",
    "item": 2
   }
  ],
  "觀念教學:元件樹與專案結構,把遊戲排成一棵樹#2": [
   {
    "say": "樹上最重要的三個動作:add、remove、children。",
    "item": 0
   },
   {
    "say": "add 是把元件掛到目前這個節點底下;removeFromParent 是把元件從樹上拿下來;children 是目前節點的所有子元件。",
    "item": 1
   },
   {
    "say": "例如在遊戲的 onLoad 裡,先 add 背景,再 add 球。先加的先畫,後加的畫在上面。",
    "item": 2
   },
   {
    "say": "預設同層的元件依加入的順序更新與繪製,也可以用 priority 這個數字調整前後,數字大的畫在上面。",
    "item": 3
   },
   {
    "say": "球要畫在草地上面,所以球的 priority 要比草地大。想像成一疊透明片,priority 越大越靠近你。",
    "item": 3
   }
  ],
  "觀念教學:元件樹與專案結構,把遊戲排成一棵樹#3": [
   {
    "say": "這一頁是三個動作的語法,一樣是示意。",
    "item": 0
   },
   {
    "say": "add 加元件,removeFromParent 拿下元件,children 看所有子元件。",
    "item": 3
   },
   {
    "say": "下面開始宣告 BounceGame 這個遊戲類別,內容在下一頁。",
    "item": 4
   }
  ],
  "觀念教學:元件樹與專案結構,把遊戲排成一棵樹#4": [
   {
    "say": "接著是 onLoad 的內容,依序 add 背景與球。",
    "item": 0
   },
   {
    "say": "最後把大括號收好,這個類別就完整了。",
    "item": 1
   }
  ],
  "觀念教學:元件樹與專案結構,把遊戲排成一棵樹#5": [
   {
    "say": "階層有個很棒的好處:父動,子跟著動。",
    "item": 0
   },
   {
    "say": "元件的 position 是相對於父元件的位置。把球員放進一個野手群元件,再移動野手群,所有野手跟著整體移動,而每個野手仍然有自己的相對位置。",
    "item": 1
   },
   {
    "say": "這個特性之後做鏡頭、做球場裝飾會非常省力:移動一個節點,一整串東西一起移動。",
    "item": 1
   }
  ],
  "觀念教學:元件樹與專案結構,把遊戲排成一棵樹#6": [
   {
    "say": "我們把樹畫成圖,而不是只放在腦袋裡。",
    "item": 0
   },
   {
    "say": "範例 Bounce Lab 的樹,根是 BounceGame,底下有三個孩子:草地 Background、球 Ball,還有顯示 dt 的 DebugText。",
    "item": 1
   },
   {
    "say": "影片裡我們讓節點一個一個長出來。你自己做專案時也養成習慣:動手寫程式之前,先在紙上畫出這棵樹。",
    "item": 2
   }
  ],
  "觀念教學:元件樹與專案結構,把遊戲排成一棵樹#7": [
   {
    "say": "這是那棵樹的文字版。",
    "item": 0
   },
   {
    "say": "根是 BounceGame。",
    "item": 1
   },
   {
    "say": "第一個孩子是 Background,草地。第二個孩子是 Ball,球。",
    "item": 3
   },
   {
    "say": "最後一個孩子是 DebugText,顯示 dt。",
    "item": 4
   }
  ],
  "觀念教學:座標系與時間 dt,讓球在任何手機上一樣快#1": [
   {
    "say": "你辛辛苦苦做了一顆球,在自己的手機上每一幀移動三像素,速度剛剛好。",
    "item": 0
   },
   {
    "say": "寄給朋友一試,朋友問:你的球怎麼飛那麼快?原來朋友的手機是一百二十赫茲。",
    "item": 1
   },
   {
    "say": "每幀三像素,六十幀就是每秒一百八十像素,一百二十幀就是每秒三百六十像素,快了整整一倍。",
    "item": 1
   },
   {
    "say": "這個不好笑但很好笑的悲劇,是用幀當單位的下場。解法只有一個:用秒當單位,而 dt 就是翻譯機。",
    "item": 2
   }
  ],
  "觀念教學:座標系與時間 dt,讓球在任何手機上一樣快#2": [
   {
    "say": "先講座標,因為移動就是座標的變化。",
    "item": 1
   },
   {
    "say": "在 Flame 的預設畫面座標中,原點在左上角,x 往右增加,y 往下增加。以三百六十乘六百四十的畫面來說,一百八十、三百二十就在正中央。",
    "item": 2
   },
   {
    "say": "注意,這跟數學課本相反:數學的 y 往上,螢幕的 y 往下。所以球往上飛,在程式裡是 y 變小。",
    "item": 3
   },
   {
    "say": "很多新手第一次寫跳躍,會把球寫得越跳越深,別擔心,每位前輩都曾經這樣。",
    "item": 3
   },
   {
    "say": "Flame 用 Vector2 存二維座標,例如 Vector2 一百八十、三百二十,可以加、減,也可以乘以數字。",
    "item": 4
   }
  ],
  "觀念教學:座標系與時間 dt,讓球在任何手機上一樣快#3": [
   {
    "say": "這一頁是座標的示意圖與程式。",
    "item": 0
   },
   {
    "say": "橫軸是 x,往右增加;縱軸是 y,往下增加,記得是往下!",
    "item": 2
   },
   {
    "say": "示範程式裡,pos 是一百八十、三百二十,v 是一百八十、一百二十。",
    "item": 4
   },
   {
    "say": "你可以先在腦中算算看,pos 加上 v 乘以零點五,會變成多少?",
    "item": 4,
    "pause": 3
   }
  ],
  "觀念教學:座標系與時間 dt,讓球在任何手機上一樣快#4": [
   {
    "say": "答案揭曉:一百八十加九十,是二百七十;三百二十加六十,是三百八十。",
    "item": 0
   },
   {
    "say": "所以 pos 變成二百七十、三百八十。向量乘以數字,就是兩個分量一起乘。",
    "item": 1
   }
  ],
  "觀念教學:座標系與時間 dt,讓球在任何手機上一樣快#5": [
   {
    "say": "PositionComponent 有三個常用屬性。",
    "item": 0
   },
   {
    "say": "position 是元件錨點所在的位置,size 是元件的寬高。",
    "item": 2
   },
   {
    "say": "anchor 是錨點,決定 position 指的是元件的哪一個點。預設是左上角,設成 Anchor.center,position 就是元件的中心。",
    "item": 3
   },
   {
    "say": "為什麼要設成中心?因為球是圓的,我們談球的位置,通常想的是圓心。設成 center 之後,球碰牆的判斷也很直覺:圓心離牆至少一個半徑。",
    "item": 3
   }
  ],
  "觀念教學:座標系與時間 dt,讓球在任何手機上一樣快#6": [
   {
    "say": "最後是 dt:時間才是單位。dt 是上一幀到這一幀經過的秒數,六十赫茲時約零點零一六七,一百二十赫茲時約零點零零八三,偶爾卡一下可能變零點零五。",
    "item": 0
   },
   {
    "say": "公式很簡單:新位置等於舊位置加上速度乘以 dt。速度的單位是像素每秒,dt 是秒,相乘得到像素,單位檢查通過,公式才對。",
    "item": 0
   },
   {
    "say": "來做數字驗算。球速是每秒二百四十像素。六十赫茲每幀四像素,一秒六十幀,共二百四十像素。",
    "item": 1
   },
   {
    "say": "一百二十赫茲每幀兩像素,一秒一百二十幀,共二百四十像素。三十赫茲每幀八像素,一秒三十幀,還是二百四十像素。",
    "item": 3
   },
   {
    "say": "三種裝置,一秒都走二百四十像素,這就叫幀率無關。",
    "item": 3
   }
  ],
  "觀念教學:座標系與時間 dt,讓球在任何手機上一樣快#7": [
   {
    "say": "公式的完整寫法:新位置等於舊位置加上速度乘以 dt。",
    "item": 0
   },
   {
    "say": "把這句話刻在手機桌布上也不為過,整門課的移動幾乎都靠它。",
    "item": 1
   }
  ],
  "課後重點整理:Flame 與遊戲迴圈#1": [
   {
    "say": "好,來複習一下這一章。",
    "item": 0
   },
   {
    "say": "你做出了這門課的第一顆球,它自己會跑、會彈,而且在任何幀率的手機上速度一致。更重要的是學到一套思考方式:遊戲是時間驅動的,世界每一幀往前走一小步。",
    "item": 1
   }
  ],
  "課後重點整理:Flame 與遊戲迴圈#2": [
   {
    "say": "重點一:Flame 是什麼。",
    "item": 0
   },
   {
    "say": "它是 Flutter 的 2D 遊戲引擎套件,提供遊戲迴圈、元件、座標、輸入、碰撞、音效等工具。",
    "item": 1
   }
  ],
  "課後重點整理:Flame 與遊戲迴圈#3": [
   {
    "say": "重點二:遊戲迴圈。",
    "item": 0
   },
   {
    "say": "每一圈:取得 dt,更新世界,也就是 update,再繪製畫面,也就是 render。這圈一秒轉好幾十次。",
    "item": 1
   }
  ],
  "課後重點整理:Flame 與遊戲迴圈#4": [
   {
    "say": "重點三:元件樹。",
    "item": 0
   },
   {
    "say": "FlameGame 是根,元件用 add 掛上,父動子跟,priority 控制畫的前後。",
    "item": 1
   }
  ],
  "課後重點整理:Flame 與遊戲迴圈#5": [
   {
    "say": "重點四:座標與時間。",
    "item": 0
   },
   {
    "say": "原點在左上角,y 往下增加。anchor 決定 position 指向元件的哪一點。位移等於速度乘以 dt,速度以單位每秒定義,才能幀率無關。夾住 dt 避免瞬間移動,固定步進讓物理與重播穩定。",
    "item": 1
   }
  ],
  "課後重點整理:Flame 與遊戲迴圈#6": [
   {
    "say": "重點五:除錯的方法。",
    "item": 0
   },
   {
    "say": "先量化症狀,再列假設,接著觀測驗證,然後修正,最後再驗證一次。別憑感覺亂改,那是抽籤,不是除錯。",
    "item": 1
   }
  ],
  "課後重點整理:Flame 與遊戲迴圈#7": [
   {
    "say": "最後是關鍵數字備忘,第一頁。以下都是講義裡的示範數字。",
    "item": 0
   },
   {
    "say": "球從一百八十、三百二十出發,速度是一百八十、一百二十,半徑十六,畫面是三百六十乘六百四十。",
    "item": 1
   },
   {
    "say": "撞右牆約零點九一一秒,撞下牆約二點五三三秒。",
    "item": 2
   },
   {
    "say": "每幀三像素:六十赫茲是每秒一百八十像素,一百二十赫茲是每秒三百六十像素。",
    "item": 3
   }
  ],
  "closing": [
   {
    "say": "本章到這裡。你已經讓第一顆球動起來了,它會自己跑、會彈,而且速度不看手機臉色。",
    "item": 0
   },
   {
    "say": "記得動手做實作,再完成章末小測驗,檢查自己學會了多少。下一章見!",
    "item": 1
   }
  ]
 }
}