Class CloudRecognizer

命名空间

easyar

CloudRecognizer实现了云识别功能。云识别功能需要在云端创建云识别图库才能使用，请参考EasyAR CRS文档。 当不再需要该组件时，可以调用close对其进行关闭。close之后不应继续使用。 在使用CloudRecognizer之前，需要设置并准备好一个 ImageTracker 。任何返回的target在被track之前都应使用 loadTarget 手动加载进入 ImageTracker 。加载之后，target的识别和跟踪即和本地target的使用相同。在一个target被识别到之后，你可以从回调中获取到，然后你应该使用target uid来区分不同的target。target runtimeID是动态生成的，不适用于作为云识别情况下的target的唯一区分。

CloudRecognizer

方法

isAvailable

返回true。

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

bool easyar_CloudRecognizer_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

create

创建并连接服务器。

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

void easyar_CloudRecognizer_create(easyar_String * cloudRecognitionServiceServerAddress, easyar_String * apiKey, easyar_String * apiSecret, easyar_String * cloudRecognitionServiceAppId, easyar_CloudRecognizer * * Return)

static std::shared_ptr<CloudRecognizer> create(std::string cloudRecognitionServiceServerAddress, std::string apiKey, std::string apiSecret, std::string cloudRecognitionServiceAppId)

public static @Nonnull CloudRecognizer create(java.lang.@Nonnull String cloudRecognitionServiceServerAddress, java.lang.@Nonnull String apiKey, java.lang.@Nonnull String apiSecret, java.lang.@Nonnull String cloudRecognitionServiceAppId)

companion object fun create(cloudRecognitionServiceServerAddress: String, apiKey: String, apiSecret: String, cloudRecognitionServiceAppId: String): CloudRecognizer

+ (easyar_CloudRecognizer *)create:(NSString *)cloudRecognitionServiceServerAddress apiKey:(NSString *)apiKey apiSecret:(NSString *)apiSecret cloudRecognitionServiceAppId:(NSString *)cloudRecognitionServiceAppId

public static func create(_ cloudRecognitionServiceServerAddress: String, _ apiKey: String, _ apiSecret: String, _ cloudRecognitionServiceAppId: String) throws -> CloudRecognizer

public static CloudRecognizer create(string cloudRecognitionServiceServerAddress, string apiKey, string apiSecret, string cloudRecognitionServiceAppId)

参数

名称	类型	描述
cloudRecognitionServiceServerAddress	String
apiKey	String
apiSecret	String
cloudRecognitionServiceAppId	String

返回

类型	描述
CloudRecognizer

createWithToken

使用API Token创建并连接服务器。

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

void easyar_CloudRecognizer_createWithToken(easyar_String * cloudRecognitionServiceServerAddress, easyar_String * apiToken, easyar_String * cloudRecognitionServiceAppId, easyar_CloudRecognizer * * Return)

static std::shared_ptr<CloudRecognizer> createWithToken(std::string cloudRecognitionServiceServerAddress, std::string apiToken, std::string cloudRecognitionServiceAppId)

public static @Nonnull CloudRecognizer createWithToken(java.lang.@Nonnull String cloudRecognitionServiceServerAddress, java.lang.@Nonnull String apiToken, java.lang.@Nonnull String cloudRecognitionServiceAppId)

companion object fun createWithToken(cloudRecognitionServiceServerAddress: String, apiToken: String, cloudRecognitionServiceAppId: String): CloudRecognizer

+ (easyar_CloudRecognizer *)createWithToken:(NSString *)cloudRecognitionServiceServerAddress apiToken:(NSString *)apiToken cloudRecognitionServiceAppId:(NSString *)cloudRecognitionServiceAppId

public static func createWithToken(_ cloudRecognitionServiceServerAddress: String, _ apiToken: String, _ cloudRecognitionServiceAppId: String) throws -> CloudRecognizer

public static CloudRecognizer createWithToken(string cloudRecognitionServiceServerAddress, string apiToken, string cloudRecognitionServiceAppId)

参数

名称	类型	描述
cloudRecognitionServiceServerAddress	String
apiToken	String
cloudRecognitionServiceAppId	String

返回

类型	描述
CloudRecognizer

createByCloudSecret

使用Cloud Secret创建并连接服务器。

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

void easyar_CloudRecognizer_createByCloudSecret(easyar_String * cloudRecognitionServiceServerAddress, easyar_String * cloudRecognitionServiceSecret, easyar_String * cloudRecognitionServiceAppId, easyar_CloudRecognizer * * Return)

static std::shared_ptr<CloudRecognizer> createByCloudSecret(std::string cloudRecognitionServiceServerAddress, std::string cloudRecognitionServiceSecret, std::string cloudRecognitionServiceAppId)

public static @Nonnull CloudRecognizer createByCloudSecret(java.lang.@Nonnull String cloudRecognitionServiceServerAddress, java.lang.@Nonnull String cloudRecognitionServiceSecret, java.lang.@Nonnull String cloudRecognitionServiceAppId)

companion object fun createByCloudSecret(cloudRecognitionServiceServerAddress: String, cloudRecognitionServiceSecret: String, cloudRecognitionServiceAppId: String): CloudRecognizer

+ (easyar_CloudRecognizer *)createByCloudSecret:(NSString *)cloudRecognitionServiceServerAddress cloudRecognitionServiceSecret:(NSString *)cloudRecognitionServiceSecret cloudRecognitionServiceAppId:(NSString *)cloudRecognitionServiceAppId

public static func createByCloudSecret(_ cloudRecognitionServiceServerAddress: String, _ cloudRecognitionServiceSecret: String, _ cloudRecognitionServiceAppId: String) -> CloudRecognizer

public static CloudRecognizer createByCloudSecret(string cloudRecognitionServiceServerAddress, string cloudRecognitionServiceSecret, string cloudRecognitionServiceAppId)

参数

名称	类型	描述
cloudRecognitionServiceServerAddress	String
cloudRecognitionServiceSecret	String
cloudRecognitionServiceAppId	String

返回

类型	描述
CloudRecognizer

updateToken

更新API Token。

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

void easyar_CloudRecognizer_updateToken(easyar_CloudRecognizer * This, easyar_String * apiToken)

void updateToken(std::string apiToken)

public void updateToken(java.lang.@Nonnull String apiToken)

fun updateToken(apiToken: String): Unit

- (void)updateToken:(NSString *)apiToken

public func updateToken(_ apiToken: String) -> Void

public virtual void updateToken(string apiToken)

参数

名称	类型	描述
apiToken	String

返回

类型	描述
Void

resolve

请求识别。可用最低请求间隔为300ms。

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

void easyar_CloudRecognizer_resolve(easyar_CloudRecognizer * This, easyar_InputFrame * inputFrame, easyar_OptionalOfInt timeoutMilliseconds, easyar_CallbackScheduler * callbackScheduler, easyar_FunctorOfVoidFromCloudRecognizationResult callback)

void resolve(std::shared_ptr<InputFrame> inputFrame, std::optional<int> timeoutMilliseconds, std::shared_ptr<CallbackScheduler> callbackScheduler, std::function<void(std::shared_ptr<CloudRecognizationResult>)> callback)

public void resolve(@Nonnull InputFrame inputFrame, java.lang.@Nullable Integer timeoutMilliseconds, @Nonnull CallbackScheduler callbackScheduler, @Nonnull FunctorOfVoidFromCloudRecognizationResult callback)

fun resolve(inputFrame: InputFrame, timeoutMilliseconds: Int?, callbackScheduler: CallbackScheduler, callback: FunctorOfVoidFromCloudRecognizationResult): Unit

- (void)resolve:(easyar_InputFrame *)inputFrame timeoutMilliseconds:(NSNumber *)timeoutMilliseconds callbackScheduler:(easyar_CallbackScheduler *)callbackScheduler callback:(void (^)(easyar_CloudRecognizationResult * result))callback

public func resolve(_ inputFrame: InputFrame, _ timeoutMilliseconds: Int32?, _ callbackScheduler: CallbackScheduler, _ callback: @escaping (CloudRecognizationResult) -> Void) -> Void

public virtual void resolve(InputFrame inputFrame, Optional<int> timeoutMilliseconds, CallbackScheduler callbackScheduler, Action<CloudRecognizationResult> callback)

参数

名称	类型	描述
inputFrame	InputFrame
timeoutMilliseconds	Optional<Int32>
callbackScheduler	CallbackScheduler
callback	Action<CloudRecognizationResult>

返回

类型	描述
Void

close

停止识别并关闭连接。close之后不应继续使用。

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

void easyar_CloudRecognizer_close(easyar_CloudRecognizer * This)

void close()

public void close()

fun close(): Unit

- (void)close

public func close() -> Void

public virtual void close()

返回

类型	描述
Void