GSTargetTracker

@objc
public protocol GSTargetTracker : Peripheral

Objective-C version of TargetTracker.

The targetTracker is the peripheral used by features such as Look-At or Follow-Me. It allows to activate/ deactivate the different detection modes of the target:

  • control whether user device/controller barometer and location are actively monitored and sent to the connected drone, in order to allow the latter to track the user and/or controller,
    • forward external target detection information to the drone, in order to allow the latter to track a given target
    • configure the tracked target desired position (framing) in the video stream.

Look-At and Follow-Me interfaces will be will be activatable according to the target’s detection quality level.

Note

This class is for Objective-C only and must not be used in Swift.

  • Position of the desired target framing in the video.

    Declaration

    Swift

    @objc(framing)
var gsFraming: GSTargetFramingSetting { get }

  • Whether the controller is used as target.

    see enableControllerTracking() and disableControllerTracking()

    Declaration

    Swift

    var targetIsController: Bool { get }

  • Information on the analyzed trajectory of the target, may be nil

    Declaration

    Swift

    var targetTrajectory: TargetTrajectory? { get }

  • Forwards the result of the target analysis.

    Declaration

    Swift

    func sendTargetDetectionInfo(_ info: TargetDetectionInfo)

    Parameters

    info

    ImageDetectionInfo object

  • Enables tracking of the controller (user device or remote-control) as the current target.

    Calling this method enables forwarding of controller barometer and location information to the connected drone, so that it may track the user (or controller).

    This method should be called prior to activating the piloting interface that tracks the user such as LookAtPilotingItf or FollowPilotingItf.

    Note

    This function will force the use of Device Location Services. In order not to use these services uselessly, it is strongly recommended to stop the tracking when target detection is no longer necessary (see disableControllerTracking).

    Declaration

    Swift

    func enableControllerTracking()

  • Disables tracking of the controller (user device or remote-control) as the current target.

    Calling this method disables forwarding of controller barometer and location information to the connected drone (see enableControllerTracking).

    This method should be called once controller barometer and location info are not required to pilot the drone (eg when interfaces like LookAt or Follow are no longer used), because monitoring the barometer and device location increases battery consumption.

    Declaration

    Swift

    func disableControllerTracking()