Request

new Cesium.Request(options)

存储用于发起请求的信息。一般来说,不需要直接构造此类。
Name Type Description
options object optional An object with the following properties:
Name Type Default Description
url string optional 要请求的 url。
requestFunction Request.RequestCallback optional 发起实际数据请求的函数。
cancelFunction Request.CancelCallback optional 请求被取消时调用的函数。
priorityFunction Request.PriorityCallback optional 用于更新请求优先级的函数,每帧调用一次。
priority number 0.0 optional 请求的初始优先级。
throttle boolean false optional 是否对请求进行节流和优先级排序。如果为 false,请求将立即发送;如果为 true,请求将根据优先级进行节流和发送。
throttleByServer boolean false optional 是否按服务器对请求进行节流。
type RequestType RequestType.OTHER optional 请求的类型。
serverKey string optional 用于标识请求所发往服务器的键。

Members

请求被取消时调用的函数。
优先级是一个无单位的值,值越小表示优先级越高。 对于基于世界的对象,这通常是距相机的距离。 没有优先级函数的请求默认优先级为 0。 如果定义了 priorityFunction,此值每帧根据该调用的结果进行更新。
Default Value: 0.0
用于更新请求优先级的函数,每帧调用一次。
发起实际数据请求的函数。
请求的当前状态。

readonly throttle : boolean

是否对请求进行节流和优先级排序。如果为 false,请求将立即发送;如果为 true, 请求将根据优先级进行节流和发送。
Default Value: false

readonly throttleByServer : boolean

是否按服务器对请求进行节流。浏览器通常对 HTTP/1 服务器支持约 6-8 个并行连接, 而对 HTTP/2 服务器支持无限个连接。对于通过 HTTP/1 服务器发出的请求, 将此值设为 true 更为合适。
Default Value: false
请求的类型。
Default Value: RequestType.OTHER
要请求的 URL。

Methods

复制一个 Request 实例。
Name Type Description
result Request optional 用于存储结果的对象。
Returns:
修改后的 result 参数,如果未提供则返回一个新的 Resource 实例。

Type Definitions

Cesium.Request.CancelCallback()

请求被取消时调用的函数。

Cesium.Request.PriorityCallback()number

用于更新请求优先级的函数,每帧调用一次。
Returns:
更新后的优先级值。

Cesium.Request.RequestCallback()Promise.<void>

发起实际数据请求的函数。
Returns:
请求数据的 promise。
需要帮助?获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。