FrameRateMonitor

new Cesium.FrameRateMonitor(options)

监控 Scene 中的帧速率(每秒帧数),如果帧速率 低于阈值。 稍后,如果帧速率返回到所需的级别,则会引发一个单独的事件。 为避免为单个 场景 创建多个 FrameRateMonitor,请使用 FrameRateMonitor.fromScene 而不是显式构造实例。
Name Type Description
options object optional 对象,具有以下属性:
Name Type Default Description
scene Scene Scene 实例用于监视性能。
samplingWindow number 5.0 optional 计算平均帧速率的滑动窗口的长度,以秒为单位。
quietPeriod number 2.0 optional 启动时和每次页面可见时(即当用户 切换回选项卡),然后再开始测量性能(以秒为单位)。
warmupPeriod number 5.0 optional 预热期的长度,以秒为单位。 在预热期间,单独的 (通常较低) 帧速率是必需的。
minimumFrameRateDuringWarmup number 4 optional 在 预热期。 如果在 warmupPeriod 期间的任何 samplingWindow 期间,帧速率平均值小于此值,则 lowFrameRate 事件,并且页面将重定向到 redirectOnLowFrameRateUrl(如果有)。
minimumFrameRateAfterWarmup number 8 optional 之后可接受的性能所需的最小每秒帧数 预热期结束。 如果在 warmupPeriod 之后的任何 samplingWindow 期间,帧速率平均值小于此值,则 lowFrameRate 事件,并且页面将重定向到 redirectOnLowFrameRateUrl(如果有)。

Members

static Cesium.FrameRateMonitor.defaultSettings : object

默认帧速率监控设置。 当 FrameRateMonitor.fromScene 需要创建新的帧速率监视器,对于未传递到 FrameRateMonitor 构造函数。

lastFramesPerSecond : number

获取最近计算的最后一个 samplingWindow 的平均每秒帧数。 如果尚未计算帧速率,则此属性可能未定义。
获取在检测到低帧速率时引发的事件。 该函数将被传递 Scene 实例作为其第一个参数和每秒平均帧数 作为其第二个参数。

minimumFrameRateAfterWarmup : number

获取或设置最小 frames-per-second 之后实现可接受性能所需的 预热期结束。 如果在 warmupPeriod 之后的任何 samplingWindow 期间,帧速率平均值小于此值,则 lowFrameRate 事件,并且页面将重定向到 redirectOnLowFrameRateUrl(如果有)。

minimumFrameRateDuringWarmup : number

获取或设置最小 frames-per-second 在之后实现可接受性能所需的 预热期。 如果在 warmupPeriod 期间的任何 samplingWindow 期间,帧速率平均值小于此值,则 lowFrameRate 事件,并且页面将重定向到 redirectOnLowFrameRateUrl(如果有)。
获取帧速率在较低水平后恢复到正常水平时引发的事件。 该函数将传递 Scene 实例作为其第一个参数,并将 采样窗口上每秒的帧数作为其第二个参数。
获取或设置启动时和每次页面可见时(即当用户 切换回选项卡),然后再开始测量性能(以秒为单位)。
获取或设置计算平均帧速率的滑动窗口的长度(以秒为单位)。
获取 Scene 实例用于监视性能。
获取或设置预热期的长度(以秒为单位)。 在预热期间,单独的 (通常较低) 帧速率是必需的。

Methods

static Cesium.FrameRateMonitor.fromScene(scene)FrameRateMonitor

获取给定场景的 FrameRateMonitor。 如果场景还没有 一个 FrameRateMonitor,一个是使用 FrameRateMonitor.defaultSettings 创建的。
Name Type Description
scene Scene 要获取其 FrameRateMonitor 的场景。
Returns:
场景的 FrameRateMonitor 的 {FrameRateMonitor} 的监视器。
取消订阅此实例正在侦听的所有事件。 一旦对象被销毁,就不应该使用它;调用 isDestroyed 将导致 DeveloperError 异常。 因此 将返回值 (undefined) 分配给对象,如示例中所示。
Throws:
See:
如果此对象已销毁,则返回 true;否则为 false。

如果此对象已销毁,则不应使用;调用 isDestroyed 将导致 DeveloperError 异常。
Returns:
如果此对象被销毁,则为 True;否则为 false。
See:
暂停帧速率的监视。 要恢复监控,FrameRateMonitor#unpause 每次调用此函数时都必须调用一次。
恢复对帧速率的监视。 如果调用了 FrameRateMonitor#pause 时,此函数必须调用相同的次数,才能 实际上恢复监控。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.