docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Class FaceDevice

    A device used to control face animation capture and playback.

    Inheritance
    object
    FaceDevice
    Implements
    ITimedDataSource
    IRegistrable
    Namespace: Unity.LiveCapture.ARKitFaceCapture
    Assembly: Unity.LiveCapture.ARKitFaceCapture.dll
    Syntax
    [ExcludeFromPreset]
    [CreateDeviceMenuItem("ARKit Face Device", 0)]
    [AddComponentMenu("Live Capture/ARKit Face Capture/ARKit Face Device")]
    [HelpURL("https://docs.unity3d.com/Packages/com.unity.live-capture@3.0/manual/ref-component-arkit-face-device.html")]
    public class FaceDevice : CompanionAppDevice<IFaceClient>, ITimedDataSource, IRegistrable
    Remarks

    The face capture data is in the format of Apple's ARKit face tracking.

    Properties

    Actor

    Gets the FaceActor currently assigned to this device.

    Declaration
    public FaceActor Actor { get; set; }
    Property Value
    Type Description
    FaceActor

    The assigned actor, or null if none is assigned.

    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    BufferSize

    Declaration
    public int BufferSize { get; set; }
    Property Value
    Type Description
    int
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    FrameRate

    Declaration
    public FrameRate FrameRate { get; }
    Property Value
    Type Description
    FrameRate
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    Id

    Declaration
    public string Id { get; }
    Property Value
    Type Description
    string
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    IsSynchronized

    Declaration
    public bool IsSynchronized { get; set; }
    Property Value
    Type Description
    bool
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    MaxBufferSize

    Declaration
    public int? MaxBufferSize { get; }
    Property Value
    Type Description
    int?
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    MinBufferSize

    Declaration
    public int? MinBufferSize { get; }
    Property Value
    Type Description
    int?
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    PresentationOffset

    Declaration
    public FrameTime PresentationOffset { get; set; }
    Property Value
    Type Description
    FrameTime
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    Synchronizer

    Declaration
    public ISynchronizer Synchronizer { get; set; }
    Property Value
    Type Description
    ISynchronizer
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    Methods

    GetAssetName()

    Gets the name used for the take asset name.

    Declaration
    protected override string GetAssetName()
    Returns
    Type Description
    string

    The name of the asset.

    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    IsReady()

    Indicates whether a device is ready for recording.

    Declaration
    public override bool IsReady()
    Returns
    Type Description
    bool

    true if ready for recording; otherwise, false.

    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    LiveUpdate()

    Declaration
    public override void LiveUpdate()
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    OnClientAssigned()

    The device calls this method when a new client is assigned.

    Declaration
    protected override void OnClientAssigned()
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    OnClientUnassigned()

    The device calls this method when the client is unassigned.

    Declaration
    protected override void OnClientUnassigned()
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    OnDisable()

    This function is called when the behaviour becomes disabled.

    Declaration
    protected override void OnDisable()
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    OnEnable()

    This function is called when the object becomes enabled and active.

    Declaration
    protected override void OnEnable()
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    OnRecordingChanged()

    The device calls this method when the recording state has changed.

    Declaration
    protected override void OnRecordingChanged()
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    OnRegisterLiveProperties(IPropertyPreviewer)

    The device calls this method when a live performance starts and properties are about to change.

    Declaration
    protected override void OnRegisterLiveProperties(IPropertyPreviewer previewer)
    Parameters
    Type Name Description
    IPropertyPreviewer previewer

    The IPropertyPreviewer to use to register live properties.

    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    PresentAt(Timecode, FrameRate)

    Declaration
    public TimedSampleStatus PresentAt(Timecode timecode, FrameRate frameRate)
    Parameters
    Type Name Description
    Timecode timecode
    FrameRate frameRate
    Returns
    Type Description
    TimedSampleStatus
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    TryGetBufferRange(out FrameTime, out FrameTime)

    Declaration
    public bool TryGetBufferRange(out FrameTime oldestSample, out FrameTime newestSample)
    Parameters
    Type Name Description
    FrameTime oldestSample
    FrameTime newestSample
    Returns
    Type Description
    bool
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    UpdateDevice()

    Declaration
    public override void UpdateDevice()
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    Write(ITakeBuilder)

    Declaration
    public override void Write(ITakeBuilder takeBuilder)
    Parameters
    Type Name Description
    ITakeBuilder takeBuilder
    See Also
    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces

    Implements

    ITimedDataSource
    IRegistrable

    See Also

    https://developer.apple.com/documentation/arkit/tracking_and_visualizing_faces
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)