Table of Contents

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。

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

創建並連接伺服器。

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創建並連接伺服器。

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創建並連接伺服器。

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。

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。

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之後不應繼續使用。

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