Cocos Creator 源碼解讀:引擎啟動與主循環


前言

本文基於 Cocos Creator 2.4.3 撰寫。

Ready?

不知道你有沒有想過,假如把游戲世界比作一輛汽車,那么這輛“汽車”是如何啟動,又是如何持續運轉的呢?

如題,本文的內容主要為 Cocos Creator 引擎的啟動流程主循環

而在主循環的內容中還會涉及到:組件的生命周期和計時器、緩動系統、動畫系統和物理系統等...

本文會在宏觀上為大家解讀主循環與各個模塊之間的關系,對於各個模塊也會簡單介紹,但不會深入到模塊的具體實現。

畢竟如果要把每個模塊都“摸”一遍,那這篇文章怕是寫不完了。

Let's Go!

希望大家看完這篇文章之后能夠更加了解 Cocos Creator 引擎。

同時也希望本文可以起到「領進門」的作用,大家一起加油呀~

另外《源碼解讀》系列(應該)會持續更新,如果你想要皮皮來解讀解讀引擎的某個模塊,也歡迎留言告訴我,我...我考慮下哈哈哈~


正文

啟動流程

index.html

對於 Web 平台來說 index.html 文件就是程序的起點。

在默認的 index.html 文件中,定義了游戲啟動頁面的布局,加載了 main.js 文件,並且還有一段立即執行的代碼。

📝 這里截取 main.js 文件中一部分比較關鍵的代碼:

// 加載引擎腳本
loadScript(debug ? 'cocos2d-js.js' : 'cocos2d-js-min.ec334.js', function () {
  // 是否開啟了物理系統?
  if (CC_PHYSICS_BUILTIN || CC_PHYSICS_CANNON) {
    // 加載物理系統腳本並啟動引擎
    loadScript(debug ? 'physics.js' : 'physics-min.js', window.boot);
  } else {
    // 啟動引擎
    window.boot();
  }
});

上面這段代碼主要用於加載引擎腳本和物理系統腳本,腳本加載完成之后就會調用 main.js 中定義的 window.boot 函數。

📱 原生平台

對於原生平台,會在 {項目目錄}build\jsb-link\frameworks\runtime-src\Classes\AppDelegate.cpp 文件的 applicationDidFinishLaunching 函數中加載 main.js 文件。

——來自渡鴉大佬的補充

📦 代碼壓縮

腳本文件名中帶有 -min 字樣(如 index.min.js)一般代表着這個文件內的代碼是被壓縮過的。

壓縮代碼可以節省代碼文件所占用的空間,加快文件加載速度,減少流量消耗,但同時也讓代碼失去了可閱讀性,不利於調試。

所以開啟調試模式后會直接使用未經過壓縮的代碼文件,便於開發調試和定位錯誤。

main.js

boot

對於不同平台 main.js 的內容也有些許差異,這里我們忽略差異部分,只關注其中關鍵的共同行為。

關於 main.js 文件的內容基本上就是定義了 window.boot 函數。

💡 對於非 Web 平台,會在定義完之后直接就調用 window.boot 函數,所以 main.js 就是他們的起點。

window.boot 函數內部有以下關鍵行為:

  1. 定義 onStart 函數:主要用於加載啟動場景
  2. cc.assetManager.init(...):初始化 AssetManager
  3. cc.assetManager.loadScript(...):加載 src 目錄下的插件腳本
  4. cc.assetManager.loadBundle(...):加載項目中的 bundle
  5. cc.game.run(...):啟動引擎

這部分的代碼就不貼了,小伙伴們可以看看自己的項目構建后的 main.js 文件。

cc.game

cc.game 對象是 cc.Game 類的一個實例,cc.game 包含了游戲主體信息並負責驅動游戲。

說人話,cc.game 對象就是管理引擎生命周期的模塊,啟動、暫停和重啟等操作都需要用到它。

[源碼] CCGame.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCGame.js

run

cc.game.run 函數內指定了引擎配置和 onStart 回調並觸發 cc.game.prepare() 函數。

📝 源碼節選:

函數:cc.game.run

run: function (config, onStart) {
  // 指定引擎配置
  this._initConfig(config);
  this.onStart = onStart;
  this.prepare(game.onStart && game.onStart.bind(game));
}

[源碼] CCGame.js#L491: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCGame.js#L491

prepare

cc.game.prepare 函數內主要在項目預覽時快速編譯項目代碼並調用 _prepareFinished 函數。

📝 源碼節選:

函數:cc.game.prepare

prepare(cb) {
  // 已經准備過則跳過
  if (this._prepared) {
    if (cb) cb();
    return;
  }
  // 加載預覽項目代碼
  this._loadPreviewScript(() => {
    this._prepareFinished(cb);
  });
}

[源碼] CCGame.js#L472: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCGame.js#L472

🛠 快速編譯

對於快速編譯的細節,可以在項目預覽時打開瀏覽器的開發者工具,在 Sources 欄中搜索(Ctrl + P) __quick_compile_project__ 即可找到 __quick_compile_project__.js 文件。

_prepareFinished

cc.game._prepareFinished() 函數的作用主要為初始化引擎、設置幀率計時器和初始化內建資源(effect 資源和 material 資源)。

當內建資源加載完成后就會調用 cc.game._runMainLoop() 啟動引擎主循環。

📝 源碼節選:

函數:cc.game._prepareFinished

_prepareFinished(cb) {
  // 初始化引擎
  this._initEngine();
  // 設置幀率計時器
  this._setAnimFrame();
  // 初始化內建資源(加載內置的 effect 和 material 資源)
  cc.assetManager.builtins.init(() => {
    // 打印引擎版本到控制台
    console.log('Cocos Creator v' + cc.ENGINE_VERSION);
    this._prepared = true;
    // 啟動 mainLoop
    this._runMainLoop();
    // 發射 ‘game_inited’ 事件(代表引擎已初始化完成)
    this.emit(this.EVENT_GAME_INITED);
    // 調用 main.js 中定義的 onStart 函數
    if (cb) cb();
  });
}

[源碼] CCGame.js#L387: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCGame.js#L387

_setAnimFrame

💡 對於 _prepareFinished 函數內調用的 _setAnimFrame 函數這里必須提一下。

cc.game._setAnimFrame 函數內部對不同的游戲幀率做了適配。

另外還對 window.requestAnimationFrame 函數做了兼容性封裝,用於兼容不同的瀏覽器環境,具體的我們下面再說。

這里就不貼 _setAnimFrame 函數的代碼了,有需要的小伙伴可自行查閱。

[源碼] CCGame.js#L564: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCGame.js#L564

_runMainLoop

cc.game._runMainLoop 函數的名字取得很簡單直接,攤牌了它就是用來運行 mainLoop 函數的。

📝 源碼節選:

函數:cc.game._runMainLoop

_runMainLoop: function () {
  if (CC_EDITOR) return;
  if (!this._prepared) return;
  // 定義局部變量
  var self = this, callback, config = self.config,
    director = cc.director,
    skip = true, frameRate = config.frameRate;
  // 展示或隱藏性能統計
  debug.setDisplayStats(config.showFPS);
  // 設置幀回調
  callback = function (now) {
    if (!self._paused) {
      // 循環調用回調
      self._intervalId = window.requestAnimFrame(callback);
      if (!CC_JSB && !CC_RUNTIME && frameRate === 30) {
          if (skip = !skip) return;
      }
      // 調用 mainLoop
      director.mainLoop(now);
    }
  };
  // 將在下一幀開始循環回調
  self._intervalId = window.requestAnimFrame(callback);
  self._paused = false;
}

[源碼] CCGame.js#L612: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCGame.js#L612

通過以上代碼我們可以得知,_runMainLoop 函數主要通過 window.requestAnimFrame 函數來實現循環調用 mainLoop 函數。

requestAnimFrame

window.requestAnimFrame 函數就是我們上面說到的 _setAnimFrame 函數內部對於 window.requestAnimationFrame 函數的兼容性封裝。

對前端不太熟悉的小伙伴可能會有疑問,window.requestAnimationFrame 又是啥,是用來干嘛的,又是如何運行的?

requestAnimationFrame

簡單來說,window.requestAnimationFrame 函數用於向瀏覽器請求進行一次重繪(repaint),並在重繪之前調用指定的回調函數。

window.requestAnimationFrame 函數接收一個回調作為參數並返回一個整數作為唯一標識,瀏覽器將會在下一個重繪之前執行這個回調;並且執行回調時會傳入一個參數,參數的值與 performance.now() 返回的值相等。

🕒 Performance.now()

performance.now() 的返回值可以簡單理解為瀏覽器窗口的運行時長,即從打開窗口到當前時刻的時間差。

[MDN] Performance.now(): https://developer.mozilla.org/zh-CN/docs/Web/API/Performance/now

回調函數的執行次數通常與瀏覽器屏幕刷新次數相匹配,也就是說,對於刷新率為 60Hz 的顯示器,瀏覽器會在一秒內執行 60 次回調函數。

對於 window.requestAnimationFrame 函數的說明到此為止,如果想要了解更多信息請自行檢索。

[MDN] window.requestAnimationFrame: https://developer.mozilla.org/zh-CN/docs/Web/API/Window/requestAnimationFrame

小結

🎨 畫一張圖來對引擎的啟動流程做一個小小的總結叭~

主循環

🎯 經歷了一番波折后,終於來到了最期待的引擎主循環部分,話不多說,我們繼續!

cc.director

cc.director 對象是導演類 cc.Director 的實例,引擎通主要過 cc.director 對象來管理游戲的邏輯流程。

[源碼] CCDirector.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCDirector.js

mainLoop

cc.director.mainLoop 函數可能是引擎中最關鍵的邏輯之一了,包含的內容很多也很關鍵。

現在讓我們進入 mainLoop 函數內部來一探究竟吧!

📝 源碼節選:

函數:cc.Director.prototype.mainLoop

這里我選擇性剔除掉了函數中的一些代碼,還加了點注釋。

mainLoop: function(now) {
  // 計算“全局”增量時間(DeltaTime)
  // 也就是距離上一次調用 mainLoop 的時間間隔
  this.calculateDeltaTime(now);
  // 游戲沒有暫停則進行更新
  if (!this._paused) {
    // 發射 'director_before_update' 事件
    this.emit(cc.Director.EVENT_BEFORE_UPDATE);
    // 調用新增的組件(已啟用)的 start 函數
    this._compScheduler.startPhase();
    // 調用所有組件(已啟用)的 update 函數
    this._compScheduler.updatePhase(this._deltaTime);
    // 更新調度器(cc.Scheduler)
    this._scheduler.update(this._deltaTime);
    // 調用所有組件(已啟用)的 lateUpdate 函數
    this._compScheduler.lateUpdatePhase(this._deltaTime);
    // 發射 'director_after_update' 事件
    this.emit(cc.Director.EVENT_AFTER_UPDATE);
    // 銷毀最近被移除的實體(節點)
    Obj._deferredDestroy();
  }
  // 發射 'director_before_draw' 事件
  this.emit(cc.Director.EVENT_BEFORE_DRAW);
  // 渲染游戲場景
  renderer.render(this._scene, this._deltaTime);
  // 發射 'director_after_draw' 事件
  this.emit(cc.Director.EVENT_AFTER_DRAW);
  // 更新事件管理器的事件監聽(cc.eventManager 已被廢棄)
  eventManager.frameUpdateListeners();
  // 累加游戲運行的總幀數
  this._totalFrames++;
}

[源碼] CCDirector.js#L843: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/CCDirector.js#L843

🔬 接下來我們來對主循環中的關鍵點一一進行分解。

ComponentScheduler

cc.director 對象中的 _compScheduler屬性 是 ComponentScheduler 類的實例。

大多數小伙伴可能對於 ComponentScheduler 這個類沒有什么印象,我來簡單解釋一下。

ComponentScheduler 的名字直譯過來就是“組件調度器”,從名字上就可以看出,這個類是用來調度組件的。

說人話,ComponentScheduler 類是用來集中調度(管理)游戲場景中所有組件(cc.Component)的生命周期的。

🎨 文字不夠直觀,看完下面這張圖大概就懂了:

[源碼] component-scheduler.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/component-scheduler.js

startPhase

📝 mainLoop 函數代碼片段:

// 調用上一幀新增(且已啟用)的組件的 start 函數
this._compScheduler.startPhase();

組件的 start 回調函數會在組件第一次激活前,也就是第一次執行 update 之前觸發。

在組件的一生中 start 回調只會被觸發一次。

start 則會等到下一次主循環 mainLoop() 時才觸發。

💡 知識補充

生命周期中的 onLoadonEnable 是由 NodeActivator 類的來管理的:

  • onLoad 在節點首次激活時觸發
  • onEnable 在組件每次被啟用時都會觸發

🎛 NodeActivator

NodeActivator 類主要用於激活和反激活節點以及節點身上的組件。

cc.director 對象中就擁有一個實例 _nodeActivator。如激活節點時會調用 cc.director._nodeActivator.activateNode(this, value);

[源碼] node-activator.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/node-activator.js

updatePhase

📝 mainLoop 函數代碼片段:

// 調用所有(已啟用)組件的 update 函數
this._compScheduler.updatePhase(deltaTime);

組件的 update 回調每一幀都會被觸發一次。

lateUpdatePhase

📝 mainLoop 函數代碼片段:

// 調用所有組件(已啟用)的 lateUpdate 函數
this._compScheduler.lateUpdatePhase(deltaTime);

組件的 lateUpdate 回調會在「組件 update 回調執行后、調度器(cc.Scheduler)更新后」被觸發。

調度器(cc.Scheduler)的更新內容包括緩動、動畫和物理等,這一點下面會展開。

ParticleSystem

BTW,粒子系統組件(cc.ParticleSystem)就是在 lateUpdate 回調函數中進行更新的。

[源碼] CCParticleSystem.js#L923: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/particle/CCParticleSystem.js#L923

一個建議

請謹慎使用 updatelateUpdate 回調,因為它們每一幀都會被觸發,如果 updatelateUpdate 內的邏輯過多,就會使得每一幀的執行時間(即幀時間 Frame time)都變長,導致游戲運行幀數降低或出現不穩定的情況。

📢 注意:這個建議不是不讓你用,該用還得用,只是不要濫用,不要啥玩意都往里邊塞~

Scheduler

cc.director 對象的 _scheduler 屬性是 cc.Scheduler 類的一個實例。

cc.Scheduler 是負責觸發回調函數的類。

[源碼] Scheduler.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/Scheduler.js

📝 mainLoop 函數代碼片段:

你絕對猜不到下面這一行看起來如此平平無奇的代碼執行之后會發生什么。

// 更新調度器(cc.Scheduler 類實例)
this._scheduler.update(this._deltaTime);

cc.director.mainLoop 函數中使用調度器 _schedulerupdate 函數來分發 update,在調度器內部會根據優先級先后觸發各個系統模塊和組件計時器的更新。

系統模塊

調度器的更新會先觸發以下系統模塊的更新:

  • ActionManager
  • AnimationManager
  • CollisionManager
  • PhysicsManager
  • Physics3DManager
  • InputManager

以上這些模塊都以 cc.director._scheduler.scheduleUpdate() 的方式注冊到調度器上,因為這些模塊每一幀都需要進行更新。

除了 InputManager 以外的模塊的優先級都為 cc.Scheduler.PRIORITY_SYSTEM,也就是「系統優先級」,會優先被觸發。

ActionManager

ActionManager動作管理器,用於管理游戲中的所有動作,也就是緩動系統 ActionTween(其實它們本質上是同一種東西)。

[源碼] CCActionManager.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/actions/CCActionManager.js

AnimationManager

AnimationManager動畫管理器,用於管理游戲中的所有動畫,驅動節點上的 Animation 組件播放動畫。

[源碼] animation-manager.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/animation/animation-manager.js

CollisionManager

CollisionManager碰撞組件管理器,用於處理節點之間的碰撞組件是否產生了碰撞,並調用相應回調函數。

[源碼] CCCollisionManager.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/collider/CCCollisionManager.js

PhysicsManager

PhysicsManager物理系統管理器,內部以 Box2D 作為 2D 物理引擎,加以封裝並開放部分常用的接口。同時 PhysicsManager 還負責管理碰撞信息的分發。

[源碼] CCPhysicsManager.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/physics/CCPhysicsManager.js

Physics3DManager

Physics3DManager3D 物理系統管理器,Cocos Creator 中的 3D 物理引擎有 Cannon.jsBuiltin 可選,Physics3DManager 給它們封裝了統一的常用接口。

[源碼] physics-manager.ts: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/3d/physics/framework/physics-manager.ts

InputManager

InputManager輸入事件管理器,用於管理所有輸入事件。開發者主動啟用加速度計(Accelerometer)之后,引擎會定時通過 InputManager 發送 cc.SystemEvent.EventType.DEVICEMOTION 事件(默認間隔為 0.2 秒)。

[源碼] CCInputManager.js: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d\core\platform\CCInputManager.js

組件計時器

相信大多數小伙伴都使用過組件的 schedulescheduleOnce 函數,主要用來延遲或重復執行指定的函數。

實際上,cc.Componentschedule 函數依賴的也是 cc.Scheduler 類,具體使用的也是 cc.director 對象中的 _scheduler 實例。

組件的 schedule 函數在 cc.director._scheduler.schedule 函數之外加了一層封裝,「以組件自身作為 target,這樣一來組件內的定時任務就與組件生命周期綁定,當組件被銷毀時定時任務也會被移除。」

scheduleOnce 函數則是在組件的 schedule 接口之外又加了一層簡單的封裝,寫死只會在指定時間后執行一次。

[源碼] CCComponent.js#L555: https://github.com/cocos-creator/engine/blob/2.4.3/cocos2d/core/components/CCComponent.js#L555

[文檔] 使用計時器: http://docs.cocos.com/creator/manual/zh/scripting/scheduler.html

setTimeout & setInterval

另外我還注意到,有不少小伙伴還不是很清楚組件的計時器和 setTimeoutsetInterval 之間的區別和用法,那就趁這個機會簡單講一下吧~

首先,setTimeoutsetInterval 函數都是由瀏覽器或 Node.js 這類 runtime 所提供的接口。

  • setTimeout 函數用於設置一個定時器,該定時器在定時器到期后執行一個函數或指定的一段代碼。
  • setInterval 函數用於重復調用一個函數或執行一個代碼段,在每次調用之間具有固定的時間延遲。
知識補充

在瀏覽器中 setTimeoutsetInterval 函數的最小延時(間隔)是 4ms。

如果是未激活(處於后台)的標簽頁(tab),最小延時(間隔)則加長到 1000ms。

🌰 舉個栗子

假如我在當前標簽頁設置了一個每 500ms 輸出一個 log 的定時器,當我切換到別的標簽頁之后,那么這個定時器就會變成每 1000ms 才輸出一個 log。

📝 像這樣(可以自己跑跑看):

setInterval(() => {
  console.log(Date.now());
}, 500);
// 模擬輸出
// 標簽頁在前台
// 1604373521000
// 1604373521500
// 1604373522000
// 切換到別的標簽頁后
// 1604373523000
// 1604373524000
// 1604373525000
區別 & 用法

組件的計時器依賴於引擎的 mainLoop() 和組件自身,如果引擎被暫停,那么組件的計時器也會被暫停,如果組件或組件所在的節點被銷毀了,那么計時器也會失效。

setTimeout()setInterval() 都依賴於當前所處的 window 對象,也就是說只要當前瀏覽器標簽頁不關閉,setTimeout()setInterval() 都還是會執行的。

當你需要在組件內部定時或重復執行某一函數或操作某個節點,那么可以使用組件的計時器。

💬 讓我們想象一個場景:

在當前場景中的某個腳本內使用 setInterval() 來重復移動場景中的某個節點,當我們切換場景后會發生什么?

當定時器再次調用回調嘗試移動節點的時候,會無法找到目標節點而報錯,因為節點已經跟着之前的場景一起被銷毀了,而定時器還在繼續執行。

這種情況下使用組件的計時器就不會有這種問題,因為計時器會隨着組件的銷毀而被清除。

而當我們需要執行一些與游戲場景沒有關聯的事情的時候,就可以考慮使用 setTimeout()setInterval()

🎃 當然能用組件計時器的話最好還是用組件計時器啦~

小結

🎨 同樣也畫一張圖來小小總結一下 Scheduler

總結

🎉 關於引擎的啟動流程和主循環就解讀到這里啦。

如果有遺漏或錯誤的地方,也歡迎大家提出來,畢竟熬夜寫文章精神恍惚漏了也是情有可原的對吧哈哈哈~

🎨 最后的最后,再畫一張圖來做一個最后的總結~

🤣 逐漸愛上畫圖~


傳送門

微信推文版本

個人博客:菜鳥小棧

開源主頁:陳皮皮

Eazax Cocos 游戲開發工具包


更多分享

《Cocos Creator 性能優化:DrawCall》

《在 Cocos Creator 里畫個炫酷的雷達圖》

《用 Shader 寫個完美的波浪》

《在 Cocos Creator 中優雅且高效地管理彈窗》

《JavaScript 內存詳解 & 分析指南》

《Cocos Creator 編輯器擴展:Quick Finder》

《JavaScript 原始值與包裝對象》


公眾號

菜鳥小棧

😺 我是陳皮皮,一個還在不斷學習的游戲開發者,一個熱愛分享的 Cocos Star Writer。

🎨 這是我的個人公眾號,專注但不僅限於游戲開發和前端技術分享。

💖 每一篇原創都非常用心,你的關注就是我原創的動力!

Input and output.


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM