2.2.1. ライセンス認証API

ライセンス認証に関するフローは、「ライセンス認証方法」をご参照ください

stid_face_professional_set_proxy_address

機能：プロキシ経由でのオンラインライセンス認証を行う場合、プロキシサーバーのIPアドレスとポート番号を設定します。アクティベーションコードインターフェイスの前に呼び出してください。

定義:

typedef enum {
    STID_PROXY_TYPE_NONE ///< プロキシを使用しない
    STID_PROXY_TYPE_HTTP_FORWARD ///< http転送プロキシ：現在は使用できません
    STID_PROXY_TYPE_HTTP_TUNNEL ///< HTTPトンネルプロキシ：プロキシがターゲットサーバーに接続した後、クライアントから送信されたすべてのデータをサーバーに転送します
} stid_proxy_type_t;

STID_SDK_API
stid_result_t
stid_face_professional_set_proxy_address(
    const char* ip,
    int port,
    stid_proxy_type_t proxy_type
);

引数:

• [In] ip：プロキシサーバーのIPアドレス

  [In] port：プロキシサーバーのポート

返り値:

• [return]：正常の場合はSTID_OKが表示され、エラーの場合はエラーコードが表示されます。

アクティベーションコードインターフェイスの前に呼び出してください。

stid_face_professional_online_activate_license

機能：オンラインでライセンス認証を行います。

アクティブ化したライセンスファイルが出力されます。オンラインで認証するため、ネットワークの接続状態によっては、ネットワーク同期画像リクエストされる可能性があります。このAPIは、ネットワークへの接続権限が必要なAPIです。

オフラインでライセンス認証する場合、このAPIは必要ありません。

定義:

STID_SDK_API
stid_result_t
stid_face_professional_online_activate_license(
    const char *inactive_license_content,
    char** out_activated_license_content
);

引数:

• [In] inactive_license_content：アクティブ化していないライセンスコードを入力するため、アクティブ化していないライセンスファイルを呼び出す必要があります。

• [out] out_activated_license_content：アクティブ化したライセンスコードが戻されます。API stid_license_release_content ファイルを解放する必要があります。

返り値:

• [return]：正常の場合はSTID_OKが表示され、エラーの場合はエラーコードが表示されます。

各デバイスは、まず初回のみライセンス認証を行い、その後アクティブ化したライセンスファイルをローカルに保存します。SDKを実行する度にAPI load_license_contentでアクティブ化したライセンスファイルをロードし、その際に認証を行っています。

stid_face_professional_load_license_content

機能：ライセンス認証ファイルをロードします（文字列）

定義：

STID_SDK_API
stid_result_t
stid_face_professional_load_license_content(
    const char* license_content
);

引数：

• [in] license_content：アクティベーションコードを入力してください。それにより、アクティブ化したライセンスファイルをサポートします（API online_activate_licenseで得た引数です）。

• 返り値:

• [return]：正常の場合はSTID_OKが表示されます（エラーになった場合はエラーコードが表示）。同一デバイスのライセンス認証ファイルを複数回ロードすると、エラーメッセージとして次のように表示されます。 STID_E_PRODUCT_LICENSE_LOADED 。

stid_license_release_content

機能：アクティブ化したライセンスファイルを解放します。

定義：

STID_SDK_API
void
stid_license_release_content(
    const char* content
);

引数：

• [in] 解放するライセンス認証ファイルを入力してください。

返り値：ありません。