FrameRateMonitor

new LSGlobe.FrameRateMonitor ( options )

监视 Scene 中的帧速率(每秒帧数),如果帧速率为低于阈值。以后,如果帧频返回所需的水平,则会引发一个单独的事件。为避免为单个 Scene 创建多个FrameRateMonitor,请使用 FrameRateMonitor。 fromScene 而不是显式构造实例。
Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 默认 说明
场景 场景 要监视其性能的Scene实例。
samplingWindow 数字 5.0 可选 计算平均帧速率的滑动窗口的长度,以秒为单位。
quietPeriod 数字 2.0 可选 启动时以及每次页面可见后(即当用户 在开始评估效果之前,会切换回标签页)。
warmupPeriod 数字 5.0 可选 预热时间的长度(以秒为单位)。在热身期间, (通常是较低的)帧速率。
minimumFrameRateDuringWarmup 数字 4 可选 在以下情况下可接受的性能所需的最小每秒帧数 预热期。如果在warmupPeriod期间的任何采样窗口期间帧速率平均小于此速率,则 lowFrameRate事件将引发,页面将重定向到redirectOnLowFrameRateUrl(如果有)。
minimumFrameRateAfterWarmup 数字 8 可选 可接受的性能之后所需的最小每秒帧数 预热期结束。如果warmupPeriod之后的任何采样窗口期间帧速率平均小于此速率,则 lowFrameRate事件将引发,页面将重定向到redirectOnLowFrameRateUrl(如果有)。

Members

static LSGlobe.FrameRateMonitor.defaultSettings : Object

默认帧速率监视设置。这些设置在 FrameRateMonitor.fromScene 时使用需要创建一个新的帧速率监视器,并针对未传递给 FrameRateMonitor 构造函数。

lastFramesPerSecond : Number

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

minimumFrameRateAfterWarmup : Number

获取或设置可接受的性能之后所需的每秒最小帧数预热期结束。如果在 warmupPeriod 之后的任何 samplingWindow 中,帧速率平均小于此速率,则 lowFrameRate 事件将引发,并且页面将重定向到 redirectOnLowFrameRateUrl (如果有)。

minimumFrameRateDuringWarmup : Number

获取或设置在以下情况下可接受的性能所需的最小每秒帧数:预热期。如果在 warmupPeriod 期间的任何 samplingWindow 中,帧速率平均小于此速率,则 lowFrameRate 事件将引发,并且页面将重定向到 redirectOnLowFrameRateUrl (如果有)。
获取较低的帧频后返回正常水平时引发的事件。该函数将通过 Scene 实例作为其第一个参数和平均值采样窗口上每秒的帧数作为其第二个参数。
获取或设置启动以及每当页面可见时(即当用户在开始评估效果之前(以秒为单位)。

samplingWindow : Number

获取或设置要在其上计算平均帧速率的滑动窗口的长度(以秒为单位)。
获取要监视其性能的 Scene 实例。

warmupPeriod : Number

获取或设置预热时间的长度(以秒为单位)。在热身期间,(通常较低)的帧速率。

Methods

static LSGlobe.FrameRateMonitor.fromScene (scene) FrameRateMonitor

获取给定场景的 FrameRateMonitor 。如果场景还没有 FrameRateMonitor ,其中一个是通过 FrameRateMonitor.defaultSettings 代码>
Name Type Description
scene Scene 要获取 FrameRateMonitor 的场景。
Returns:
现场的 FrameRateMonitor
取消订阅该实例的所有监听事件。一旦物体被破坏,就不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。因此,如示例中所述,将返回值( undefined )分配给对象。
Throws:
See:

isDestroyed () Boolean

如果此对象已销毁,则返回true;否则返回false。否则为假。

如果该对象被破坏,则不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。
Returns:
如果该对象被破坏,则为true;否则为false。否则为假。
See:
暂停监视帧速率。要恢复监视,请 FrameRateMonitor#unpause 每次调用此函数时必须调用一次。
恢复监视帧速率。如果调用了 FrameRateMonitor#pause 多次,此函数必须调用相同的次数才能实际恢复监视。