Request

new Cesium.Request(options)

存储发起请求的信息。一般来说,这个对象不需要直接构造。
Name Type Description
options object optional 一个具有以下属性的对象:
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:
修改后的结果参数,如果未提供,则返回一个新实例。

Type Definitions

Cesium.Request.CancelCallback()

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

Cesium.Request.PriorityCallback()number

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

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

实际进行数据请求的函数。
Returns:
请求数据的 Promise。
需要帮助?获得答案的最快方法是来自社区和团队 Cesium Forum.