From 8a4ffff97b7484f0003b5961a13f3e82ced7d4e2 Mon Sep 17 00:00:00 2001 From: uye <99072975+ABA2396@users.noreply.github.com> Date: Tue, 7 Jul 2026 00:30:48 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=A2=9E=E5=8A=A0=E6=88=AA=E5=9B=BE?= =?UTF-8?q?=E7=9B=B8=E5=85=B3=E5=9B=9E=E8=B0=83=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en-us/protocol/callback-schema.md | 22 ++++++++++++++++++++++ docs/ja-jp/protocol/callback-schema.md | 22 ++++++++++++++++++++++ docs/ko-kr/protocol/callback-schema.md | 22 ++++++++++++++++++++++ docs/zh-cn/protocol/callback-schema.md | 22 ++++++++++++++++++++++ docs/zh-tw/protocol/callback-schema.md | 22 ++++++++++++++++++++++ 5 files changed, 110 insertions(+) diff --git a/docs/en-us/protocol/callback-schema.md b/docs/en-us/protocol/callback-schema.md index b35cb1e0c4..06c1dd7f90 100644 --- a/docs/en-us/protocol/callback-schema.md +++ b/docs/en-us/protocol/callback-schema.md @@ -108,6 +108,28 @@ Todo Screenshot failed (adb/emulator crashed), and retry failed - `TouchModeNotAvailable` Unsupported touch mode +- `ResolutionGot` + Resolution retrieved +- `FastestWayToScreencap` + Fastest screenshot method found, `details` structure: + + - `method` (string, required): Fastest screenshot method. + - `cost` (number, required): Time cost in milliseconds. + - `alternatives` (array, required): All candidate methods and their costs. + +- `ScreencapCost` + Screenshot cost statistics (reported every 10 screenshots), `details` structure: + + - `min` (number, required): Minimum cost in milliseconds. + - `max` (number, required): Maximum cost in milliseconds. + - `avg` (number, required): Average cost in milliseconds. + - `fault_times` (number): Number of failures (only present when there are failures). + +- `EmulatorFPS` + Emulator refresh rate (checked every 1 minute), `details` structure: + + - `fps` (number, required): Emulator/system refresh rate (FPS). + - `refresh_period_ns` (number, required): Frame refresh period in nanoseconds. ### AsyncCallInfo diff --git a/docs/ja-jp/protocol/callback-schema.md b/docs/ja-jp/protocol/callback-schema.md index e542e3e769..2bab13e0dd 100644 --- a/docs/ja-jp/protocol/callback-schema.md +++ b/docs/ja-jp/protocol/callback-schema.md @@ -111,6 +111,28 @@ Todo 画面取得失敗 (adb/emulator クラッシュ), 再接続失敗 - `TouchModeNotAvailable` サポートされていないタッチモード +- `ResolutionGot` + 解像度を取得しました +- `FastestWayToScreencap` + 最速のスクリーンショット方式が見つかりました、`details` 構造： + + - `method` (string, required): 最速のスクリーンショット方式。 + - `cost` (number, required): 所要時間（ミリ秒）。 + - `alternatives` (array, required): 全候補方式とその所要時間。 + +- `ScreencapCost` + スクリーンショット所要時間統計（10回ごとに報告）、`details` 構造： + + - `min` (number, required): 最小所要時間（ミリ秒）。 + - `max` (number, required): 最大所要時間（ミリ秒）。 + - `avg` (number, required): 平均所要時間（ミリ秒）。 + - `fault_times` (number): 失敗回数（失敗がある場合のみ存在）。 + +- `EmulatorFPS` + エミュレータリフレッシュレート（1分ごとに検出）、`details` 構造： + + - `fps` (number, required): エミュレータ/システムのリフレッシュレート（FPS）。 + - `refresh_period_ns` (number, required): フレーム更新周期（ナノ秒）。 ### AsyncCallInfo diff --git a/docs/ko-kr/protocol/callback-schema.md b/docs/ko-kr/protocol/callback-schema.md index 6cbe74c475..fcceba18b3 100644 --- a/docs/ko-kr/protocol/callback-schema.md +++ b/docs/ko-kr/protocol/callback-schema.md @@ -119,6 +119,28 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom 스크린샷 실패 (adb / 에뮬레이터 충돌), 재시도 실패 - `TouchModeNotAvailable` 지원하지 않는 터치 모드 +- `ResolutionGot` + 해상도를 획득함 +- `FastestWayToScreencap` + 가장 빠른 스크린샷 방식을 찾음, `details` 구조: + + - `method` (string, required): 가장 빠른 스크린샷 방식. + - `cost` (number, required): 소요 시간 (밀리초). + - `alternatives` (array, required): 모든 후보 방식과 소요 시간. + +- `ScreencapCost` + 스크린샷 소요 시간 통계 (10회마다 보고), `details` 구조: + + - `min` (number, required): 최소 소요 시간 (밀리초). + - `max` (number, required): 최대 소요 시간 (밀리초). + - `avg` (number, required): 평균 소요 시간 (밀리초). + - `fault_times` (number): 실패 횟수 (실패가 있는 경우에만 존재). + +- `EmulatorFPS` + 에뮬레이터 주사율 (1분마다 검사), `details` 구조: + + - `fps` (number, required): 에뮬레이터/시스템 주사율 (FPS). + - `refresh_period_ns` (number, required): 프레임 주기 (나노초). ### AsyncCallInfo diff --git a/docs/zh-cn/protocol/callback-schema.md b/docs/zh-cn/protocol/callback-schema.md index 67f1f1c3f6..95e1980b55 100644 --- a/docs/zh-cn/protocol/callback-schema.md +++ b/docs/zh-cn/protocol/callback-schema.md @@ -119,6 +119,28 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom 截图失败（adb / 模拟器 炸了），并重试失败 - `TouchModeNotAvailable` 不支持的触控模式 +- `ResolutionGot` + 已获取到分辨率 +- `FastestWayToScreencap` + 已找到最快的截图方式，`details` 结构如下： + + - `method` (string, required): 最快的截图方式。 + - `cost` (number, required): 耗时，单位毫秒。 + - `alternatives` (array, required): 各候选方式及其耗时。 + +- `ScreencapCost` + 截图耗时统计（每 10 次截图回传一次），`details` 结构如下： + + - `min` (number, required): 最小耗时，单位毫秒。 + - `max` (number, required): 最大耗时，单位毫秒。 + - `avg` (number, required): 平均耗时，单位毫秒。 + - `fault_times` (number): 失败次数（仅有失败时存在）。 + +- `EmulatorFPS` + 模拟器刷新率（每 1 分钟检测一次），`details` 结构如下： + + - `fps` (number, required): 模拟器/系统刷新率（FPS）。 + - `refresh_period_ns` (number, required): 每帧刷新周期，单位纳秒。 ### AsyncCallInfo diff --git a/docs/zh-tw/protocol/callback-schema.md b/docs/zh-tw/protocol/callback-schema.md index 5960d08367..f918233a05 100644 --- a/docs/zh-tw/protocol/callback-schema.md +++ b/docs/zh-tw/protocol/callback-schema.md @@ -119,6 +119,28 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom 截圖失敗（adb / 模擬器 炸了），並重試失敗 - `TouchModeNotAvailable` 不支援的觸控模式 +- `ResolutionGot` + 已獲取到解析度 +- `FastestWayToScreencap` + 已找到最快的截圖方式，`details` 結構如下： + + - `method` (string, required): 最快的截圖方式。 + - `cost` (number, required): 耗時，單位毫秒。 + - `alternatives` (array, required): 各候選方式及其耗時。 + +- `ScreencapCost` + 截圖耗時統計（每 10 次截圖回傳一次），`details` 結構如下： + + - `min` (number, required): 最小耗時，單位毫秒。 + - `max` (number, required): 最大耗時，單位毫秒。 + - `avg` (number, required): 平均耗時，單位毫秒。 + - `fault_times` (number): 失敗次數（僅有失敗時存在）。 + +- `EmulatorFPS` + 模擬器更新率（每 1 分鐘檢測一次），`details` 結構如下： + + - `fps` (number, required): 模擬器/系統更新率（FPS）。 + - `refresh_period_ns` (number, required): 每幀更新週期，單位奈秒。 ### AsyncCallInfo