Contents

reportVolatileMetadataUpdate:

Updates the volatile metadata within the current state without beginning a new transition.

Declaration

- (void) reportVolatileMetadataUpdate:(NSDictionary<NSString *,NSObject *> *) updatedMetadata;

Parameters

  • updatedMetadata:

    The updated volatile context, or nil to clear volatile metadata without ending the current state. Dictionary values must be NSNumber, NSString, or NSDate. Passing values of any other type is a programmer error and will raise an exception.

Discussion

Use this method to update rapidly-changing data — such as a progress value or a running count — while staying within the same state. If no state is currently active, this call is a no-op. Calling this method more frequently than user interaction timescales can trigger rate limiting, causing updates to go unlogged.