Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Waits until an event object is available or the specified amount of milliseconds have passed. When an event object becomes available, it will be returned. If the timeout is reached, Invalid will be returned. Passing a zero as the timeout value instructs this method to wait indefinitely for a message.

...

Enables a watchdog timeout on the roMessagePort instance . The watchdog on roMessagePort is disabled by default. Passing if passed a positive integer to this method instructs the watchdog to . The watchdog will crash and reboot the player if the script does not call GetMessage() or WaitMessage() does not return after  after the specified number of seconds. Passing zero to this method disables the watchdog again.

...

titleNote

...

.

Some BrightScript operations (e.g. roAssetRealizer.Realize()) can take a long time to return. In these cases, it may be better to use a short watchdog timeout in general but switch to a longer timeout before calling such operations.

The watchdog timeout only applies to its associated roMessagePort instance, so enabling the watchdog on one roMessagePort instance, then calling WaitMessage() on another, may cause the watchdog to trigger unexpectedly. The watchdog will not trigger while waiting on the BrightScript debugger prompt. 

DeferWatchdog(seconds As Integer)

...