From b96a12a2f37a3cc633c240be807f2f956d87ed16 Mon Sep 17 00:00:00 2001
From: cocos02 <cocos02@163.com>
Date: Sun, 7 Jun 2026 17:05:59 +0800
Subject: [PATCH] docs: add comment explaining waitReady logic

---
 engine/core/VideoManager.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/engine/core/VideoManager.ts b/engine/core/VideoManager.ts
index c2f9491..a0c26ea 100644
--- a/engine/core/VideoManager.ts
+++ b/engine/core/VideoManager.ts
@@ -141,7 +141,9 @@ export class VideoManager {
   }
 
   private waitReady(el: HTMLVideoElement): Promise<void> {
+    // readyState >= 2 (HAVE_CURRENT_DATA) 表示已有足够数据播放当前帧，无需等待
     if (el.readyState >= 2) return Promise.resolve()
+    // 否则等待 canplay 事件（浏览器判断可开始播放），同时手动触发 load 确保加载流程已启动
     return new Promise((resolve) => {
       el.addEventListener('canplay', () => resolve(), { once: true })
       el.load()