Interface PresentMessagesRequest

Input to the Messages presentMessagesRequest command

See

MatterSpecification.v13.Cluster § 1.16.7.1

interface PresentMessagesRequest {
    duration: null | number | bigint;
    messageControl: TypeFromPartialBitSchema<{
        confirmationRequired: BitFlag;
        messageConfirmed: BitFlag;
        messageProtected: BitFlag;
        replyMessage: BitFlag;
        responseRequired: BitFlag;
    }>;
    messageId: Uint8Array;
    messageText: string;
    priority: Messages.MessagePriority;
    responses?: TypeFromFields<{
        label: FieldType<string>;
        messageResponseId: FieldType<number>;
    }>[];
    startTime: null | number;
}

Hierarchy (view full)

Properties

duration messageControl messageId messageText priority responses? startTime

Properties

duration

duration: null | number | bigint

This field shall indicate the amount of time, in milliseconds, after the StartTime during which the message is available to be presented. A null value shall indicate "until changed". See Duration.

See

MatterSpecification.v13.Cluster § 1.16.7.1.5

messageControl

messageControl: TypeFromPartialBitSchema<{
    confirmationRequired: BitFlag;
    messageConfirmed: BitFlag;
    messageProtected: BitFlag;
    replyMessage: BitFlag;
    responseRequired: BitFlag;
}>

This field shall indicate control information related to the message. See MessageControl.

Type declaration

  • confirmationRequired: BitFlag

    Message requires confirmation from user

    This bit shall indicate that the message originator requests a confirmation of receipt by the user. If confirmation is required, the device SHOULD present the message until it is either confirmed by the user selecting a confirmation option, or the message expires.

    See

    MatterSpecification.v13.Cluster § 1.16.5.2.1

  • messageConfirmed: BitFlag

    Message has already been confirmed

    This bit shall indicate the current confirmation state of a message, which is useful in the event that there are multiple Messages cluster client devices on a network.

    See

    MatterSpecification.v13.Cluster § 1.16.5.2.4

  • messageProtected: BitFlag

    Message required PIN/password protection

    This bit shall indicate that user authentication (e.g. by password or PIN) is required before viewing a message.

    See

    MatterSpecification.v13.Cluster § 1.16.5.2.5

  • replyMessage: BitFlag

    Message supports reply message from user

    This bit shall indicate that a free-form user reply is to be included in the confirmation of receipt.

    See

    MatterSpecification.v13.Cluster § 1.16.5.2.3

  • responseRequired: BitFlag

    Message requires response from user

    This bit shall indicate that a MessagePresented event SHOULD be generated based on the response of the user to the message.

    See

    MatterSpecification.v13.Cluster § 1.16.5.2.2

See

MatterSpecification.v13.Cluster § 1.16.7.1.3

messageId

messageId: Uint8Array

This field shall indicate a globally unique ID for this message. See MessageID.

See

MatterSpecification.v13.Cluster § 1.16.7.1.1

messageText

messageText: string

This field shall indicate a string containing the message to be presented. See MessageText.

See

MatterSpecification.v13.Cluster § 1.16.7.1.6

priority

priority: Messages.MessagePriority

This field shall indicate the priority level for this message. See Priority.

See

MatterSpecification.v13.Cluster § 1.16.7.1.2

Optionalresponses

responses?: TypeFromFields<{
    label: FieldType<string>;
    messageResponseId: FieldType<number>;
}>[]

This field shall indicate a list of potential responses to the message. The entries in this list shall have unique values of MessageResponseID.

If the ResponseRequired bit is set on the message but this list is empty, the device shall provide a generic acknowledgement button, e.g. "OK".

If the ResponseRequired bit is not set on the message, this list shall be ignored. See Responses.

See

MatterSpecification.v13.Cluster § 1.16.7.1.7

startTime

startTime: null | number

This field shall indicate the time in UTC at which the message becomes available to be presented. A null value shall indicate "now." See StartTime.

See

MatterSpecification.v13.Cluster § 1.16.7.1.4

Settings

Member Visibility

On This Page

Properties