mirror of
https://github.com/zhw2590582/ArtPlayer.git
synced 2026-10-08 19:06:15 -08:00
docs(site): [SITE-04] complete bilingual guides for JASSUB Mask and Cast
This commit is contained in:
1 parent
558e946ae5
commit
3aad294aa5
106 files changed
+5268
-2065
No files matched your search
@@ -211,6 +211,54 @@
|
||||
"owner": "SITE-VTT-01",
|
||||
"finalDemoOwner": "EX-03",
|
||||
"note": "Generated guide. Guide-specific browser evidence belongs to the owner; this entry does not complete full demo/release acceptance."
|
||||
},
|
||||
{
|
||||
"source": "docs/document/plugin/jassub.html",
|
||||
"route": "/document/plugin/jassub.html",
|
||||
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
|
||||
"owner": "SITE-04",
|
||||
"finalDemoOwner": "EX-03",
|
||||
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
|
||||
},
|
||||
{
|
||||
"source": "docs/document/en/plugin/jassub.html",
|
||||
"route": "/document/en/plugin/jassub.html",
|
||||
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
|
||||
"owner": "SITE-04",
|
||||
"finalDemoOwner": "EX-03",
|
||||
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
|
||||
},
|
||||
{
|
||||
"source": "docs/document/plugin/danmuku-mask.html",
|
||||
"route": "/document/plugin/danmuku-mask.html",
|
||||
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
|
||||
"owner": "SITE-04",
|
||||
"finalDemoOwner": "EX-03",
|
||||
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
|
||||
},
|
||||
{
|
||||
"source": "docs/document/en/plugin/danmuku-mask.html",
|
||||
"route": "/document/en/plugin/danmuku-mask.html",
|
||||
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
|
||||
"owner": "SITE-04",
|
||||
"finalDemoOwner": "EX-03",
|
||||
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
|
||||
},
|
||||
{
|
||||
"source": "docs/document/plugin/chromecast.html",
|
||||
"route": "/document/plugin/chromecast.html",
|
||||
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
|
||||
"owner": "SITE-04",
|
||||
"finalDemoOwner": "EX-03",
|
||||
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
|
||||
},
|
||||
{
|
||||
"source": "docs/document/en/plugin/chromecast.html",
|
||||
"route": "/document/en/plugin/chromecast.html",
|
||||
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
|
||||
"owner": "SITE-04",
|
||||
"finalDemoOwner": "EX-03",
|
||||
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
|
||||
}
|
||||
]
|
||||
}
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,57 @@
|
||||
# SITE-04 checkpoint: JASSUB, Danmuku Mask and Chromecast guides
|
||||
|
||||
Six bilingual pages replace external-only or missing sidebar entries. All 16
|
||||
plugins now have dedicated guides in both languages. Original demo JavaScript is
|
||||
copied unchanged into visible Run Code blocks; Mask forwards both required plugin
|
||||
libraries. New routes record pre-change HEAD
|
||||
558e946ae538b6e0aac9754aed875ba521d6ca9d. This documents the unreleased branch,
|
||||
not the capabilities of a package currently fetched from the registry.
|
||||
|
||||
JASSUB covers resource/rendering options, instance methods and fields, ASS data,
|
||||
callback queries, actual resize argument order and return values, ownership and
|
||||
the preserved root versus accurate runtime declarations. Mask covers all ten
|
||||
options, fixed SDK/model selection, initialization and cancellation, previous-mask
|
||||
retention, cleanup and NodeNext type-only extraction without inventing a runtime
|
||||
default alias. Chromecast covers SDK loading, live options/callbacks, media MIME
|
||||
and URL behavior, raw/normalized state, shared sessions and async runtime types.
|
||||
Session presence is not described as receiver playback. The detailed source and
|
||||
member mapping is in [the tracker](../site-content-review.md).
|
||||
|
||||
## Verification
|
||||
|
||||
- Node24.21.0, Yarn1.22.22 and TypeScript5.9.3. Six exact TS snippets pass strict
|
||||
NodeNext with skipLibCheck:false and types:[], including JASSUB runtime and Mask
|
||||
type extraction. All six runnable examples equal their original demo files.
|
||||
- Each JASSUB/Mask page validates37 distinct local file/fragment targets; each
|
||||
Chromecast page validates38. Original/additional demo route checks pass.
|
||||
- Desktop Chromium153.0.8010.12, Firefox155.0 and Windows WebKit26.6 validate all
|
||||
18 final guide cases without retries or page errors: HTTP load, sidebar, visible
|
||||
Run Code, exact code/libs forwarding and language switch. Popup responses are
|
||||
isolated; this does not execute the editor, SDK, segmentation or media playback.
|
||||
- The initial run also passed18 cases. Its Mask screenshot exposed an excessively
|
||||
wide options table. Move the CDN link into prose and combine type/default
|
||||
columns. A separate final run retains new screenshots and verifies no horizontal
|
||||
table scrolling is required at the tested1100px viewport. Initial evidence is
|
||||
preserved; no mobile responsiveness or physical-device acceptance is inferred.
|
||||
- Existing site-loading/documentation-pipeline tests:17 pass,0 failures/skips,
|
||||
1204.8237ms. Config lint, build:llm/check:llm, build:docs and inventory checks
|
||||
pass. Final VitePress build8.46s; Yarn10.12s. No new dependency or project script.
|
||||
- Current inventory:58 Markdown (29 per language),67 HTML,30 examples,963 core
|
||||
members and204 assets. Enumeration is not complete semantic coverage.
|
||||
- All21 library build envelopes remain accepted. Library source, declarations,
|
||||
distribution and dependency inputs were not changed; release blockers remain.
|
||||
|
||||
See [the evidence record](../baselines/site04-jassub-mask-cast-guides.json).
|
||||
Generated HTML, browser assets and LLM outputs came from repository commands.
|
||||
SITE-04 remains doing; totals remain224 done/22 doing/39 todo. Two proxy and two
|
||||
tool guides, current earlier-guide checks and core semantic mapping remain.
|
||||
SITE-05/EX-03, SDK/media/device gaps and user-directed formal reviews are separate.
|
||||
|
||||
No push, remote dispatch, deployment or publication occurred. Revert this
|
||||
checkpoint to restore previous guides, navigation and generated outputs without
|
||||
changing runtime APIs, root declarations or approved compatibility decisions.
|
||||
|
||||
Full staged whitespace checking exits2 on12 whitespace-only template lines in
|
||||
the six new generated HTML files. Exact paths, lines and blank content were
|
||||
inspected; excluding only these files passes. Generated HTML is preserved,
|
||||
and the full check is not reported as passing. See the evidence record.
|
||||
+1
-1
@@ -687,7 +687,7 @@
|
||||
- SITE-DANMUKU-01: [记录](changes/2026-09-15-SITE-DANMUKU-01-guides.md) [记录](baselines/danmuku-docs-validation.json)
|
||||
- SITE-HLS-01: [记录](changes/2026-09-15-SITE-HLS-01-guides.md) [记录](baselines/hls-docs-validation.json)
|
||||
- SITE-DASH-01: [记录](changes/2026-09-15-SITE-DASH-01-guides.md) [记录](baselines/dash-docs-validation.json)
|
||||
- SITE-04: [记录](site-content-review.md) [记录](changes/2026-09-16-SITE-04-chapter-ambilight-guides.md) [记录](baselines/site04-chapter-ambilight-guides.json) [记录](changes/2026-09-16-SITE-04-dpip-asr-guides.md) [记录](baselines/site04-dpip-asr-guides.json) [记录](changes/2026-09-16-SITE-04-auto-multi-guides.md) [记录](baselines/site04-auto-multi-guides.json) [记录](changes/2026-09-16-SITE-04-ads-vast-guides.md) [记录](baselines/site04-ads-vast-guides.json)
|
||||
- SITE-04: [记录](site-content-review.md) [记录](changes/2026-09-16-SITE-04-chapter-ambilight-guides.md) [记录](baselines/site04-chapter-ambilight-guides.json) [记录](changes/2026-09-16-SITE-04-dpip-asr-guides.md) [记录](baselines/site04-dpip-asr-guides.json) [记录](changes/2026-09-16-SITE-04-auto-multi-guides.md) [记录](baselines/site04-auto-multi-guides.json) [记录](changes/2026-09-16-SITE-04-ads-vast-guides.md) [记录](baselines/site04-ads-vast-guides.json) [记录](changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md) [记录](baselines/site04-jassub-mask-cast-guides.json)
|
||||
- SITE-07: [记录](site-inventory.md) [记录](baselines/site-provenance.json) [记录](changes/2026-09-14-SITE-07-vendor-notices.md) [记录](baselines/site-notices-checkpoint.json) [记录](baselines/site-codicons-provenance.json) [记录](baselines/site-codicons-validation.json) [记录](changes/2026-09-15-SITE-07-codicons.md) [记录](baselines/vconsole-notices-provenance.json) [记录](baselines/vconsole-notices-validation.json) [记录](changes/2026-09-15-SITE-07-vconsole-notices.md) [记录](console-modernization.md) [记录](baselines/site-console-inventory.json) [记录](baselines/site-console-validation.json) [记录](changes/2026-09-15-SITE-07-console-baseline.md) [记录](baselines/console-feed-provenance.json) [记录](changes/2026-09-15-SITE-07-console-feed-source.md) [记录](baselines/console-commonjs-provenance.json) [记录](changes/2026-09-15-SITE-07-console-commonjs.md) [记录](baselines/console-esm-provenance.json) [记录](changes/2026-09-15-SITE-07-console-esm.md) [记录](baselines/console-embedded-notices.json) [记录](baselines/console-notices-validation.json) [记录](changes/2026-09-15-SITE-07-console-notices.md) [记录](baselines/console-embedded-sources.json) [记录](baselines/console-embedded-validation.json) [记录](changes/2026-09-15-SITE-07-console-embedded-sources.md) [记录](baselines/console-derived-attribution.json) [记录](baselines/console-derived-validation.json) [记录](changes/2026-09-15-SITE-07-console-derived-attribution.md) [记录](baselines/console-stackoverflow-provenance.json) [记录](baselines/console-stackoverflow-validation.json) [记录](changes/2026-09-15-SITE-07-console-stackoverflow.md) [记录](baselines/console-shallowequal-validation.json) [记录](changes/2026-09-15-SITE-07-console-shallowequal.md) [记录](console-notice-review.md) [记录](baselines/console-notice-review-validation.json) [记录](changes/2026-09-15-SITE-07-console-notice-review.md) [记录](baselines/monaco-typescript-provenance.json) [记录](baselines/monaco-typescript-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-typescript.md) [记录](baselines/monaco-languages-provenance.json) [记录](baselines/monaco-languages-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-languages.md) [记录](baselines/monaco-language-notices.json) [记录](baselines/monaco-language-notices-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-language-notices.md) [记录](baselines/monaco-modes-provenance.json) [记录](baselines/monaco-modes-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-modes.md) [记录](baselines/monaco-basic-provenance.json) [记录](baselines/monaco-basic-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-basic.md) [记录](baselines/monaco-core-origins-provenance.json) [记录](baselines/monaco-core-origins-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-core-origins.md) [记录](baselines/monaco-core-build-provenance.json) [记录](baselines/monaco-core-build-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-core-build.md) [记录](baselines/monaco-contributions-provenance.json) [记录](baselines/monaco-contributions-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-contributions.md) [记录](baselines/monaco-css-build-provenance.json) [记录](baselines/monaco-css-build-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-css.md) [记录](baselines/monaco-node-path-provenance.json) [记录](baselines/monaco-node-path-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-node-path.md) [记录](changes/2026-09-15-SITE-07-monaco-dom.md) [记录](baselines/monaco-dom-origins-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-unicode.md) [记录](baselines/monaco-unicode-provenance.json) [记录](baselines/monaco-unicode-validation.json) [记录](changes/2026-09-15-SITE-07-font-notices.md) [记录](baselines/site-font-notices-provenance.json) [记录](baselines/site-font-notices-validation.json)
|
||||
- EX-01: [记录](changes/2026-09-14-EX-01-react-consumer.md) [记录](baselines/react-consumer-validation.json) [记录](scripts/react-consumer.mjs)
|
||||
- EX-02: [记录](changes/2026-09-14-EX-02-vue-consumer.md) [记录](baselines/vue-consumer-validation.json) [记录](scripts/vue-consumer.mjs)
|
||||
|
||||
@@ -1,5 +1,17 @@
|
||||
# 进度与证据
|
||||
|
||||
## SITE-04 JASSUB/弹幕遮罩/Chromecast双语指南
|
||||
|
||||
补齐六份页面、本地导航和原样示例,16个插件现均有独立双语指南。说明JASSUB实际
|
||||
方法/查询/资源、遮罩start与首帧/SDK配置边界、Cast会话与接收端播放区别。
|
||||
六份TS片段、37/38个页面链接、三浏览器18组最终导航及17项工具测试通过。
|
||||
截图发现遮罩表格过宽后调整列和CDN链接,保留初轮证据并重新验证最终页面宽度。
|
||||
当前58 Markdown/67 HTML,21库build仍有效。见
|
||||
[记录](changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md)和
|
||||
[证据](baselines/site04-jassub-mask-cast-guides.json)。SITE-04保持doing,224/22/39
|
||||
不变;继续proxy/tool、已有指南和核心语义对应,不将导航计为SDK/媒体/设备通过,
|
||||
不启动用户保留的正式复盘。
|
||||
|
||||
## SITE-04 Ads/VAST双语指南
|
||||
|
||||
补齐四份页面、本地导航和原样示例。Ads说明计时/媒体控制、skip与按钮限制、
|
||||
|
||||
@@ -32,13 +32,21 @@ Ads 和 VAST 的本次核对:
|
||||
| Ads | [入口](../packages/artplayer-plugin-ads/src/index.ts)、options.ts、countdown.ts、view.ts、session.ts、根/runtime声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/ads.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/ads.md):七个配置及四项i18n、name/play/pause/skip、click/skip事件、十个公开类型 | video优先、可信HTML、浅合并、计时非视频时长、按钮限制不拦截直接skip、ready/首播/早调用/销毁、事件活配置、totalDuration推导修正和忽略source/type |
|
||||
| VAST | [入口](../packages/artplayer-plugin-vast/src/index.ts)、sdk.ts、session.ts、view.ts、根/runtime声明、README/ARCHITECTURE与两项已批准决策 | [中文](../packages/artplayer-vitepress/docs/plugin/vast.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/vast.md):回调/第二参数、全部context字段、init/playUrl/playRes、name/destroy、runtime命名类型及工作区别名 | npm默认回调前创建/数据快照,显式workspace惰性/getter/请求抑制/事件;config可覆盖主字段;注册等待回调非广告完成;session可重建/core终止;旧根类型与准确runtime分离,外部IMA仍单独验收 |
|
||||
|
||||
JASSUB、弹幕遮罩和 Chromecast 的本次核对:
|
||||
|
||||
| 包 | 对照源码与声明 | 双语指南覆盖 | 保留边界 |
|
||||
| --- | --- | --- | --- |
|
||||
| JASSUB | [入口](../packages/artplayer-plugin-jassub/src/index.ts)、registration.ts、vendor实现、根/runtime声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/jassub.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/jassub.md):全部RuntimeOption;实例方法与字段;AssEvent/AssStyle;13个runtime命名类型 | 同步注册非Worker ready;实际resize参数/void返回与旧声明分开;query回调/target关联/毫秒单位;资源部署、caller节点归属、晚到位图与销毁;离屏停顿和字体/真机缺口保留 |
|
||||
| Danmuku Mask | [入口](../packages/artplayer-plugin-danmuku-mask/src/index.ts)、config.ts、controller.ts、output.ts、sdk.ts、根/legacy声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/danmuku-mask.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/danmuku-mask.md):十项配置、name/start/stop、NodeNext类型提取、双插件示例 | truthy默认值、固定MediaPipe/general与忽略字段、start不保证首mask、stop等待关系、无人物保留mask、model失败与其他拒绝区别;无runtime/新事件;SDK私有GPU完成未证明 |
|
||||
| Chromecast | [入口](../packages/artplayer-plugin-chromecast/src/index.ts)、controller.ts、media.ts、sdk.ts、根/runtime声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/chromecast.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/chromecast.md):四项设置/四回调、name/getCastState/isCasting、八个命名类型与旧根兼容 | options必填/活读取、首次点击加载、共享SDK/首URL、30秒ready期限、原始与标准状态、请求取消、绝对媒体URL/MIME、销毁不结束共享会话;有会话不等于接收端播放,真机仍独立验收 |
|
||||
|
||||
## 接续范围
|
||||
|
||||
- 核心:依据 site-inventory.json 的 963 条成员逐项或按明确的共享声明分组核对;
|
||||
必须记录对应文档及语义结论,不能仅按同名标题匹配标为通过。
|
||||
- 已有 Danmuku、HLS、DASH、Audio、VTT 双语指南:继承各 SITE-* 任务的证据,但
|
||||
仍需在本轮全包核对中检查其当前声明、示例和能力边界。
|
||||
- 其余插件、两个 proxy、两个 tool:包内 README/ARCHITECTURE 不能替代缺失的
|
||||
- 16个插件现均有独立双语指南;两个 proxy、两个 tool:包内 README/ARCHITECTURE 不能替代缺失的
|
||||
双语使用说明。按实际能力分组补入口,不机械复制维护文档。
|
||||
- SITE-05 和 EX-03 负责后续完整页面与实际 demo 验收;静态内容核对不等待真机,
|
||||
也不能据此关闭真机、外部 SDK、发布或复盘门槛。
|
||||
|
||||
+3
-1
@@ -4564,7 +4564,9 @@
|
||||
"changes/2026-09-16-SITE-04-auto-multi-guides.md",
|
||||
"baselines/site04-auto-multi-guides.json",
|
||||
"changes/2026-09-16-SITE-04-ads-vast-guides.md",
|
||||
"baselines/site04-ads-vast-guides.json"
|
||||
"baselines/site04-ads-vast-guides.json",
|
||||
"changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md",
|
||||
"baselines/site04-jassub-mask-cast-guides.json"
|
||||
]
|
||||
},
|
||||
{
|
||||
|
||||
Reference in new issue
Block a user