用途:整理 CesiumJS 核心工具与网络请求相关能力,覆盖 Resource、Color、Event、RequestScheduler、错误处理、辅助函数与特性检测,帮助在 CesiumJS v1.144+ 项目中正确调用这些 API。
主要能力:Resource 统一处理 HTTP 操作,支持 fetchJson、fetchText、fetchArrayBuffer、fetchBlob、fetchImage,可配置 queryParameters、headers、proxy 与 retry;通过 getDerivedResource 继承配置,setQueryParameters、appendQueryParameters 修改查询参数,DefaultProxy 以查询参数形式转发目标 URL,支持 post、put。Color 以 [0,1] 浮点 RGBA 表示,提供 140 多个 PascalCase 命名常量,并支持 fromCssColorString、fromBytes、fromHsl、fromRandom 等构造及 withAlpha、brighten、darken、toCssHexString 等转换。Event 为发布订阅机制,addEventListener 返回移除函数,EventHelper 可批量清理。RequestScheduler 为单例,控制 maximumRequests、maximumRequestsPerServer 与 requestsByServer。错误处理区分 DeveloperError 与 RuntimeError,formatError 可提取信息。辅助函数包括 defined、clone、combine、createGuid、buildModuleUrl、objectToQuery、queryToObject、getExtensionFromUri、getBaseUri、destroyObject,以及 AssociativeArray、PinBuilder、DistanceDisplayCondition、FeatureDetection、Fullscreen、TaskProcessor、TrustedServers。
必要用法:v1.134 起移除 defaultValue,改用 ?? 与 Frozen.EMPTY_OBJECT / Frozen.EMPTY_ARRAY。例如 fetchJson 使用 await Resource.fetchJson({ url: "..." }),TaskProcessor 需在完成后 destroy(),PinBuilder 用于生成标记画布。
适用场景:CesiumJS 三维地球应用中的瓦片请求、颜色配置、事件订阅、并发调度与资源清理。
限制:仅覆盖核心工具与网络部分,未包含 Viewer 初始化、影像提供者与实体 API 的完整细节;开发者错误不应当捕获,需修正调用代码;未提供收费与平台信息。