Developer Portal
Quick StartsComposition scriptingAPIs and SDKsSupport
  • Portal overview
  • Quick start
  • REST API
    • Introduction
    • Rate limits
    • Authorization
    • How-to guides
      • Get a control app's API token
      • Get a composition's sub-composition IDs and names and their payload structures
      • Get a control app's model
      • Get a control app's metadata
      • Update a sub-composition's content
      • Update a sub-composition's animation state
      • Update a sub-composition's content and animation state in one call
      • Update multiple sub-compositions in one call
    • API reference
      • Get control app details
        • Get a control app's metadata
        • Get a control app's model
        • Get a control app's control data
      • Send data to a control app
        • Update a control app's content
        • Update a control app's animation state
      • Take out all of an app's output
  • Data stream API
    • Introduction
    • Rate limits
    • Authorization
    • How-to guides
      • Create a data stream
      • Link a data stream to a composition
      • Send data to an app using the data stream API
    • API reference
  • Composition scripting
    • Introduction
    • Overview
    • Quick start
      • Find sub-compositions and widgets
      • Read and update control nodes
      • Set text widget text properties
      • Read and update widget properties
      • Read control nodes and update widget properties
      • Set image widget URL property
      • Set table widget content property
    • Cheat sheets
      • Fundamentals
      • Interactive overlays
      • Best practices
    • Use cases
      • Read control nodes and generate HTML text
      • Read control nodes, generate HTML text with background
      • Text Ticker - Start ticker on "In" animation
    • Composition script editor reference
  • Software development kits
    • Graphics SDK
      • Getting started
      • Reference
        • SDK functions
        • Composition object
        • Sequencer object
      • Guides and examples
        • Load a composition with its token
        • Load a composition with its URL
        • Get the composition URL of an app instance
        • Sequencer VOD example
        • Control local preview of app
        • Load app instance output
    • Overlay SDK
      • Getting started
      • SDK functions
      • Use case examples
    • Widget SDK
      • Preparing your environment
      • Getting started
      • Reference
        • Widget UI definition
        • Widget callback functions
        • Time control object
        • Composition instance
      • Guides and examples
        • Widget example: CSS patterns
    • App SDK
  • Singular Basics
    • Overview of Singular
    • Managing overlays in the Dashboard
      • How to create a new composition
      • How to open a new app template
      • How to create an app for a composition
      • How to extract a composition from an app
      • How to find an app's shared app token and shared API URL
      • Dashboard reference
    • Building overlays in Composer
      • How to build a composition
      • How to set up layer logic to automate overlay transitions
      • How to set up control nodes to make widget properties available to a control app
      • Animating overlays
        • How to create timeline animations
        • How to create behavior animations
        • How to create update animations
      • How to make overlays interactive
      • How to adapt overlays to various screen sizes
      • Composer reference
    • Controlling overlays in Studio and UNO
      • How to use Studio
      • Studio reference
      • UNO reference
  • Support
    • Singular status
    • Support resources
    • Singular terminology
    • Performance Testing
Powered by GitBook
On this page
  • onSingularInit()
  • onSingularValue()
  • onSingularButtonClicked()
  • onSingularEditComp()
  • onSingularAnimation()

Was this helpful?

  1. Software development kits
  2. Widget SDK
  3. Reference

Widget callback functions

onSingularInit()

Debug Console
onSingularInit(): {OffsetToServerTime: -589.5, adaptationGlobals: {…}}
> OffsetToServerTime: -589.5
> adaptationGlobals: {}

onSingularValue()

Debug Console
onSingularValue(): {idLabel: ' ', idText: 'enter text here ...', idTextArea: 'Enter text into this area...', idNumber: '50.0', idCheckbox: false, …}
> idCheckbox: false
> idColor: {r: 155, g: 155, b: 155, a: 1}
> idComposition: "325724b5-03b8-46cf-93cb-16a2587dfb21"
> idGradient: "#9B9B9B"
> idImage: "https://app.singular.live/images/logo.png"
> idJson: "{}"
> idLabel: " "
> idNumber: "50.0"
> idSelection: "1"
> idText: "enter text here ..."
> idTextArea: "Enter text into this area..."
> idUseCustomParameter: false

onSingularButtonClicked()

Debug Console
onSingularButtonClicked(): idButton

onSingularEditComp()

Debug Console
onSingularEditComp(): idComposition

onSingularAnimation()

Debug Console
onSingularAnimation(): {event: 'init', timeline: 'In', duration: 0.5, animationEvent: 'play', direction: 'forward', …}
> animationEvent: "play"
> direction: "forward"
> duration: 0.5
> easing: {easing: 'linear', inOut: 'out'}
> event: "init"
> newState: "In"
> oldState: "Out1"
> state: "In"
> timeline: "In"

PreviousWidget UI definitionNextTime control object

Last updated 2 years ago

Was this helpful?