docs.unity3d.com
    Show / Hide Table of Contents

    Timecode synchronization

    The Live Capture package includes features that allow you to temporally synchronize all compatible Live Capture devices connected to the Unity Editor according to a centralized timecode source.

    Main use cases

    Takes with multiple devices: If you record takes that simultaneously involve multiple capture devices, you might need to mark the start of the recording for each device with a reliable timecode to ensure all recordings can be correctly aligned and effectively synchronized when replayed using Timeline or exported to a third party software.

    Live scenarios: If you use the Unity Editor for real-time output, you need to synchronize all external inputs via a timecode provided with each input sample, so that each frame output by the engine is temporally coherent.

    Overall concept

    Live Capture's timecode synchronization overall structure conceptually relies on three main types of interconnected elements:

    • Data sources
    • Timecode source
    • Timecode Synchronizer

    The data sources are Live Capture compatible devices connected to the Unity Editor for data transmission purposes. For example, the Unity Virtual Camera and Unity Face Capture apps installed on mobile devices are data sources.

    The timecode source is typically a device or a chain of devices connected with the Unity Editor and all data sources to provide them a centralized timecode for further synchronization. For example, the timecode source can be a timecode generator such as Tentacle Sync, an audio device transmitting a Linear Time Code (LTC), or a combination of both.

    The Timecode Synchronizer is a tool in the Unity Editor that processes and compares all timecodes received via the data sources with the one directly received from the timecode source. The Timecode Synchronizer provides the synchronization status of each data source in real time, and allows to adjust the necessary parameters to get a perfect synchronization of all data sources.

    Supported data sources

    • Any supported mobile device with Bluetooth enabled and one of the Live Capture companion apps installed:
      • Unity Virtual Camera
      • Unity Face Capture

    Supported timecode sources

    The Live Capture package and companion apps currently support a limited set of timecode source hardware:

    • The Unity Virtual Camera and Unity Face Capture apps only support the Tentacle Sync timecode generator.
    • The Timecode Synchronizer in Unity Editor supports Linear Time Code (LTC) and Network Time Protocol (NTP) as timecode input.

    Note: Tentacle Sync devices usually support LTC input, which allows you to get a functional timecode synchronization setup despite these current limitations.

    Additionally, the Live Capture package provides a means to use the Unity Editor workstation system clock as the timecode source. However, you should only use it for testing purposes, as it might provide inaccurate results if you use it for synchronization purposes.

    Timecode Synchronizer structure

    In the Unity Editor, a Timecode Synchronizer typically consists of a GameObject with:

    • A Timecode Synchronizer component
    • A Timecode source component from the available ones:
      • LTC Timecode Source
      • NTP Timecode Source
      • System Clock Timecode Source
    In This Article
    • Main use cases
    • Overall concept
    • Supported data sources
    • Supported timecode sources
    • Timecode Synchronizer structure
    Back to top
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023