start()

start()は、ログイン済みのMonitorDog SDK sessionでdetector runtimeを実行する関数です。

login()が認証/sessionとアカウント/ポリシーの準備を完了した後、start()がモデルロード、カメラ権限リクエスト、Webカメラstream、detection loopを担当します。

役割

start()が呼び出されると、SDKは内部的に次の処理を順番に実行します。

ログイン状態を確認
-> 検知モデルをload
-> カメラ権限をリクエスト
-> Webカメラstreamを開始
-> detection loopを実行

使用例

await detector.login({
  email: currentUser.email,
});

await detector.start();

すでにdetectorが実行中の状態でstart()を再度呼び出すと、成功no-opとして処理されます。

失敗処理

start()は次の状況で失敗することがあります。

• login()前に呼び出した場合: NOT_LOGGED_IN
• 検知モデルloadに失敗した場合: MODEL_LOAD_FAILED
• ブラウザカメラ権限が拒否された場合: CAMERA_PERMISSION_DENIED
• カメラstreamを読み取れない場合: CAMERA_READ_FAILED
• その他のruntime開始失敗: RUNTIME_START_FAILED

注意事項

• カメラ権限promptはlogin()ではなくstart()時点で表示されます。
• 画面やcomponentが消えるときは、まずstop()でlocal detectionを停止してください。
• token/sessionはstart()ではなくlogin()とlogout()が管理します。