@companion-module/base
    Preparing search index...

    Interface CompanionAdvancedFeedbackDefinition<TOptions>

    The definition of an advanced feedback It is discouraged to use this type of feedback, as it does not fit into our graphics model, or user flexibility goals as well as the other types of feedback. This type will likely be removed in a future major version of the module API.

    interface CompanionAdvancedFeedbackDefinition<
        TOptions extends CompanionOptionValues = CompanionOptionValues,
    > {
        affectedProperties:
            | (
                | "text"
                | "size"
                | "color"
                | "bgcolor"
                | "alignment"
                | "pngalignment"
                | "png64"
                | "imageBuffer"
            )[]
            | undefined;
        callback: (
            feedback: CompanionFeedbackAdvancedEvent<TOptions>,
            context: CompanionFeedbackCallbackContext,
        ) =>
            | CompanionAdvancedFeedbackResult
            | Promise<CompanionAdvancedFeedbackResult>;
        description?: string;
        learn?: (
            feedback: CompanionFeedbackInfo<TOptions>,
            context: CompanionLearnCallbackContext,
        ) => Partial<TOptions> | Promise<Partial<TOptions> | undefined> | undefined;
        learnTimeout?: number;
        name: string;
        options: SomeCompanionFeedbackInputField<Extract<keyof TOptions, string>>[];
        sortName?: string;
        type: "advanced";
        unsubscribe?: (
            feedback: CompanionFeedbackInfo<TOptions>,
            context: CompanionCommonCallbackContext,
        ) => void | Promise<void>;
    }

    Type Parameters

    Hierarchy (View Summary)

    Index

    Properties

    affectedProperties callback description? learn? learnTimeout? name options sortName? type unsubscribe?

    Properties

    affectedProperties:
        | (
            | "text"
            | "size"
            | "color"
            | "bgcolor"
            | "alignment"
            | "pngalignment"
            | "png64"
            | "imageBuffer"
        )[]
        | undefined

    The suggested style properties this feedback will affect Companion will use this to setup a more accurate list of style overrides, which will help users by avoiding a wall of unnecessary overrides

    callback: (
        feedback: CompanionFeedbackAdvancedEvent<TOptions>,
        context: CompanionFeedbackCallbackContext,
    ) =>
        | CompanionAdvancedFeedbackResult
        | Promise<CompanionAdvancedFeedbackResult>

    Called to get the feedback value

    description?: string

    Additional description of the feedback

    learn?: (
        feedback: CompanionFeedbackInfo<TOptions>,
        context: CompanionLearnCallbackContext,
    ) => Partial<TOptions> | Promise<Partial<TOptions> | undefined> | undefined

    The user requested to 'learn' the values for this feedback. Note: As of 2.0, you should only return the values that have been learned, so that expressions in any id fields will be preserved

    learnTimeout?: number

    Timeout for the 'learn' function (in milliseconds) Companion sets a default value of 5s, to ensure that the learn does not get stuck never completing You can change this if this number does not work for you, but you should keep it to a sensible value

    name: string

    Name to show in the feedbacks list

    options: SomeCompanionFeedbackInputField<Extract<keyof TOptions, string>>[]

    The input fields for the feedback

    sortName?: string

    Alternate value to use when sorting the list of feedbacks By default, the feedbacks are ordered by the name field, but you can override this without altering the visible name by setting this value

    type: "advanced"

    The type of the feedback

    unsubscribe?: (
        feedback: CompanionFeedbackInfo<TOptions>,
        context: CompanionCommonCallbackContext,
    ) => void | Promise<void>

    Called to report a feedback has been removed or disabled. Useful to cleanup subscriptions setup in the callback

    Settings

    Member Visibility

    On This Page

    Properties