Class ObjectTracker

名前空間

easyar

ObjectTrackerは3D object targetの検出と追跡を実装しています。 ObjectTrackerは(1 + SimultaneousNum)個のcameraのbufferを占有します。cameraのsetBufferCapacityを使用して、すべてのコンポーネントが占有するcameraのbuffer数量以上に設定する必要があります。 作成後、start/stopを呼び出して開始および停止を実行できます。start/stopは非常に軽量な呼び出しです。 このコンポーネントが不要になった場合、closeを呼び出して閉じることができます。close後は使用を続けてはいけません。 ObjectTrackerはfeedbackFrameSinkを介してFeedbackFrameを入力し、FeedbackFrameSourceをfeedbackFrameSinkに接続して使用する必要があります。 TargetがObjectTrackerによって追跡可能になる前に、loadTarget/unloadTargetを使用してロードする必要があります。load/unloadの結果は、インターフェースのコールバックを渡すことで取得できます。

ObjectTracker

メソッド

isAvailable

trueを返します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_ObjectTracker_isAvailable(void)

static bool isAvailable()

public static boolean isAvailable()

companion object fun isAvailable(): Boolean

+ (bool)isAvailable

public static func isAvailable() -> Bool

public static bool isAvailable()

戻り値

型	説明
Boolean

feedbackFrameSink

FeedbackFrame入力ポート。FeedbackFrameのInputFrameメンバーは、画像、タイムスタンプ、cameraパラメータを必ず持つ必要があり、cameraはピンホールと魚眼カメラをサポートします。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_feedbackFrameSink(easyar_ObjectTracker * This, easyar_FeedbackFrameSink * * Return)

std::shared_ptr<FeedbackFrameSink> feedbackFrameSink()

public @Nonnull FeedbackFrameSink feedbackFrameSink()

fun feedbackFrameSink(): FeedbackFrameSink

- (easyar_FeedbackFrameSink *)feedbackFrameSink

public func feedbackFrameSink() -> FeedbackFrameSink

public virtual FeedbackFrameSink feedbackFrameSink()

戻り値

型	説明
FeedbackFrameSink

bufferRequirement

現在のコンポーネントが占有するcamera bufferの数量。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

int easyar_ObjectTracker_bufferRequirement(easyar_ObjectTracker * This)

int bufferRequirement()

public int bufferRequirement()

fun bufferRequirement(): Int

- (int)bufferRequirement

public func bufferRequirement() -> Int32

public virtual int bufferRequirement()

戻り値

型	説明
Int32

outputFrameSource

OutputFrame出力ポート。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_outputFrameSource(easyar_ObjectTracker * This, easyar_OutputFrameSource * * Return)

std::shared_ptr<OutputFrameSource> outputFrameSource()

public @Nonnull OutputFrameSource outputFrameSource()

fun outputFrameSource(): OutputFrameSource

- (easyar_OutputFrameSource *)outputFrameSource

public func outputFrameSource() -> OutputFrameSource

public virtual OutputFrameSource outputFrameSource()

戻り値

型	説明
OutputFrameSource

create

作成。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_create(easyar_ObjectTracker * * Return)

static std::shared_ptr<ObjectTracker> create()

public static @Nonnull ObjectTracker create()

companion object fun create(): ObjectTracker

+ (easyar_ObjectTracker *)create

public static func create() -> ObjectTracker

public static ObjectTracker create()

戻り値

型	説明
ObjectTracker

setResultPostProcessing

結果の後処理を設定します。 enablePersistentTargetInstanceはデフォルトでfalseです。有効にすると、InputFrameデータに空間情報が含まれている場合、ImageTrackerResultのtargetInstancesは認識されたすべてのinstance（現在追跡されていないものも含む）を含みます。 enableMotionFusionはデフォルトでfalseです。有効にすると、InputFrameデータに時間情報と空間情報が含まれている場合、ImageTrackerResultのtargetInstancesのposeはRealTimeCoordinateTransformを使用して平滑化されます。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_setResultPostProcessing(easyar_ObjectTracker * This, bool enablePersistentTargetInstance, bool enableMotionFusion)

void setResultPostProcessing(bool enablePersistentTargetInstance, bool enableMotionFusion)

public void setResultPostProcessing(boolean enablePersistentTargetInstance, boolean enableMotionFusion)

fun setResultPostProcessing(enablePersistentTargetInstance: Boolean, enableMotionFusion: Boolean): Unit

- (void)setResultPostProcessing:(bool)enablePersistentTargetInstance enableMotionFusion:(bool)enableMotionFusion

public func setResultPostProcessing(_ enablePersistentTargetInstance: Bool, _ enableMotionFusion: Bool) -> Void

public virtual void setResultPostProcessing(bool enablePersistentTargetInstance, bool enableMotionFusion)

パラメーター

名前	型	説明
enablePersistentTargetInstance	Boolean
enableMotionFusion	Boolean

戻り値

型	説明
Void

setResultAsyncMode

結果の非同期モードを設定します。結果がoutputFrameSourceを介して出力される場合はtrueに設定する必要があり、結果がgetSyncResultで取得される場合はfalseに設定する必要があります。デフォルトのenableAsyncはtrueです。同期モードは、入力フレームに空間情報が含まれており、XRライセンスが使用されている場合にのみ有効になります。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_ObjectTracker_setResultAsyncMode(easyar_ObjectTracker * This, bool enableAsync)

bool setResultAsyncMode(bool enableAsync)

public boolean setResultAsyncMode(boolean enableAsync)

fun setResultAsyncMode(enableAsync: Boolean): Boolean

- (bool)setResultAsyncMode:(bool)enableAsync

public func setResultAsyncMode(_ enableAsync: Bool) -> Bool

public virtual bool setResultAsyncMode(bool enableAsync)

パラメーター

名前	型	説明
enableAsync	Boolean

戻り値

型	説明
Boolean

start

追跡アルゴリズムを開始します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_ObjectTracker_start(easyar_ObjectTracker * This)

bool start()

public boolean start()

fun start(): Boolean

- (bool)start

public func start() -> Bool

public virtual bool start()

戻り値

型	説明
Boolean

stop

追跡アルゴリズムを一時停止します。startを呼び出して追跡を再開します。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_stop(easyar_ObjectTracker * This)

void stop()

public void stop()

fun stop(): Unit

- (void)stop

public func stop() -> Void

public virtual void stop()

戻り値

型	説明
Void

close

閉じます。close後は使用を続けてはいけません。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_close(easyar_ObjectTracker * This)

void close()

public void close()

fun close(): Unit

- (void)close

public func close() -> Void

public virtual void close()

戻り値

型	説明
Void

loadTarget

Targetをtrackerにロードします。Targetは、trackerに正常にロードされた後にのみ認識および追跡できます。 この方法は非同期メソッドです。ロードプロセスには時間がかかる場合があり、その間、新しいtargetや失われたtargetの検出に通常より時間がかかる可能性がありますが、検出後の追跡には影響しません。ロードの結果を知りたい場合は、callbackデータを処理する必要があります。callbackはCallbackSchedulerで指定されたスレッドで呼び出されます。追跡スレッドや他のロード/アンロード以外の操作はブロックされません。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_loadTarget(easyar_ObjectTracker * This, easyar_Target * target, easyar_CallbackScheduler * callbackScheduler, easyar_FunctorOfVoidFromTargetAndBool callback)

void loadTarget(std::shared_ptr<Target> target, std::shared_ptr<CallbackScheduler> callbackScheduler, std::function<void(std::shared_ptr<Target>, bool)> callback)

public void loadTarget(@Nonnull Target target, @Nonnull CallbackScheduler callbackScheduler, @Nonnull FunctorOfVoidFromTargetAndBool callback)

fun loadTarget(target: Target, callbackScheduler: CallbackScheduler, callback: FunctorOfVoidFromTargetAndBool): Unit

- (void)loadTarget:(easyar_Target *)target callbackScheduler:(easyar_CallbackScheduler *)callbackScheduler callback:(void (^)(easyar_Target * target, bool status))callback

public func loadTarget(_ target: Target, _ callbackScheduler: CallbackScheduler, _ callback: @escaping (Target, Bool) -> Void) -> Void

public virtual void loadTarget(Target target, CallbackScheduler callbackScheduler, Action<Target, bool> callback)

パラメーター

名前	型	説明
target	Target
callbackScheduler	CallbackScheduler
callback	Action<,>

戻り値

型	説明
Void

unloadTarget

trackerからTargetをアンロードします。 この方法は非同期メソッドです。アンロードプロセスには時間がかかる場合があり、その間、新しいtargetや失われたtargetの検出に通常より時間がかかる可能性がありますが、検出後の追跡には影響しません。アンロードの結果を知りたい場合は、callbackデータを処理する必要があります。callbackはCallbackSchedulerで指定されたスレッドで呼び出されます。追跡スレッドや他のロード/アンロード以外の操作はブロックされません。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_unloadTarget(easyar_ObjectTracker * This, easyar_Target * target, easyar_CallbackScheduler * callbackScheduler, easyar_FunctorOfVoidFromTargetAndBool callback)

void unloadTarget(std::shared_ptr<Target> target, std::shared_ptr<CallbackScheduler> callbackScheduler, std::function<void(std::shared_ptr<Target>, bool)> callback)

public void unloadTarget(@Nonnull Target target, @Nonnull CallbackScheduler callbackScheduler, @Nonnull FunctorOfVoidFromTargetAndBool callback)

fun unloadTarget(target: Target, callbackScheduler: CallbackScheduler, callback: FunctorOfVoidFromTargetAndBool): Unit

- (void)unloadTarget:(easyar_Target *)target callbackScheduler:(easyar_CallbackScheduler *)callbackScheduler callback:(void (^)(easyar_Target * target, bool status))callback

public func unloadTarget(_ target: Target, _ callbackScheduler: CallbackScheduler, _ callback: @escaping (Target, Bool) -> Void) -> Void

public virtual void unloadTarget(Target target, CallbackScheduler callbackScheduler, Action<Target, bool> callback)

パラメーター

名前	型	説明
target	Target
callbackScheduler	CallbackScheduler
callback	Action<,>

戻り値

型	説明
Void

targets

現在trackerにロードされているtargetを返します。非同期のロード/アンロードが実行中の場合、ロード/アンロードが完了する前の戻り値はそれらの結果を反映しません。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_targets(const easyar_ObjectTracker * This, easyar_ListOfTarget * * Return)

std::vector<std::shared_ptr<Target>> targets()

public java.util.@Nonnull ArrayList<@Nonnull Target> targets()

fun targets(): ArrayList<Target>

- (NSArray<easyar_Target *> *)targets

public func targets() -> [Target]

public virtual List<Target> targets()

戻り値

型	説明
List<>

setSimultaneousNum

trackerが追跡できる最大目標数を設定します。デフォルト値は1です。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_ObjectTracker_setSimultaneousNum(easyar_ObjectTracker * This, int num)

bool setSimultaneousNum(int num)

public boolean setSimultaneousNum(int num)

fun setSimultaneousNum(num: Int): Boolean

- (bool)setSimultaneousNum:(int)num

public func setSimultaneousNum(_ num: Int32) -> Bool

public virtual bool setSimultaneousNum(int num)

パラメーター

名前	型	説明
num	Int32

戻り値

型	説明
Boolean

simultaneousNum

trackerが追跡できる最大目標数を取得します。デフォルト値は1です。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

int easyar_ObjectTracker_simultaneousNum(const easyar_ObjectTracker * This)

int simultaneousNum()

public int simultaneousNum()

fun simultaneousNum(): Int

- (int)simultaneousNum

public func simultaneousNum() -> Int32

public virtual int simultaneousNum()

戻り値

型	説明
Int32

getSyncResult

同期出力結果を取得します。ObjectTrackerが一時停止されているか、setResultAsyncModeで結果の非同期モードがfalseに設定されていない場合、戻り値は空です。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_ObjectTracker_getSyncResult(easyar_ObjectTracker * This, easyar_MotionInputData * motionInputData, easyar_OptionalOfObjectTrackerResult * Return)

std::optional<std::shared_ptr<ObjectTrackerResult>> getSyncResult(std::shared_ptr<MotionInputData> motionInputData)

public @Nullable ObjectTrackerResult getSyncResult(@Nonnull MotionInputData motionInputData)

fun getSyncResult(motionInputData: MotionInputData): ObjectTrackerResult?

- (easyar_ObjectTrackerResult *)getSyncResult:(easyar_MotionInputData *)motionInputData

public func getSyncResult(_ motionInputData: MotionInputData) -> ObjectTrackerResult?

public virtual Optional<ObjectTrackerResult> getSyncResult(MotionInputData motionInputData)

パラメーター

名前	型	説明
motionInputData	MotionInputData

戻り値

型	説明
Optional<ObjectTrackerResult>