About the Chronicle Facade and Observers

The Chronicle Facade class defines the interface to the Screencast recording utility. Your implemented FacadeObserver provides callbacks to monitor the Screencast recorder's state.

Controlling the Facade

It is not necessary to construct a Facade instance; all the member functions are static. The following member functions allow your application to start up, shut down, and query the state of the Facade:

• initialize()
• cleanup()
• isInitialized()

Your application must call the initialize() member function one time before it invokes any of the other member functions. If the Facade is already initialized, calling this method has no effect.

Immediately after you initialize your Screencast Facade, ensure that your application registers itself. Product registration is required for the Screencast recorder to properly record your application's metadata.

When you are finished with the Facade, invoke the cleanup() member function. This function unregisters your product, removes the Facade, and frees other resources.

FacadeObservers

Derive a class from Facade::Observer, for example, MyObserver. Then use the Facade static function addObserver to register your new observer. The Screencast recording utility notifies you of state changes in the recording function by calling your observer's notification functions:

• MyObserver::captureStarted()
• MyObserver::capturePaused()
• MyObserver::captureResumed()
• MyObserver::captureStopped()

Your client must respond appropriately to these events to start logging metadata, stop logging metadata and when it ends, do the necessary cleanup.

Create a FacadeObserver after running the initialize() function. Remove the FacadeObserver before running cleanup().

Your client should also create waypoints only after captureStarted() and captureResumed() and should stop creating waypoints after capturePaused() and captureStopped().