建立串流並擷取資料

使用應用程式分析影片資料的第一步，是建立持續傳輸資料的管道。Streams 可擷取即時視訊資料，並用於模型輸入或儲存在倉儲中。

建立串流

如要串流影片資料，您必須先建立串流。

第一次在新專案中建立串流時，可能需要一些時間才能建立串流。這段時間約為 30 分鐘。這是因為系統需要為後續運算初始化運算叢集。

控制台

在 Google Cloud 控制台中建立串流。

  1. 開啟 Vertex AI Vision 資訊主頁的「Streams」分頁。

    前往「串流」分頁

  2. 按一下「註冊」。

  3. 輸入串流名稱並選取區域。您可以按一下「新增資料列」，同時註冊多個串流。

  4. 按一下「註冊」按鈕，建立一或多個串流。

擷取影片

建立串流後，您就可以開始使用該串流擷取資料。

匯入的影片有以下限制和注意事項：

  • 輸入影片來源必須符合下列規格：

    如果影片不符合這些規格，Vertex AI Vision 可能無法順利處理輸入內容。

  • 擷取音訊時發生中斷。
  • 如果串流是與倉庫連線的應用程式一部分，則整個串流的影片參數 (例如 FPS 或解析度) 必須相同；不支援 RTSP 影片資料參數或本機影片資料參數的變化。
  • 由於模型啟動延遲，擷取的影片可能會缺少前幾秒的內容。這段時間最長可達 15 秒。
  • 在連線時間過長 (平均約 5 小時) 後，可能會發生擷取終止的情形。vaictl 工具沒有重新連線功能，使用者必須手動重新連線。
  • 雖然 vaictl 是擷取影片資料的實用工具，但不會自動處理網路錯誤的復原作業。這些錯誤可能來自資料來源端或雲端攝入端。使用者有責任建立重新啟動指令碼，以便處理非預期的 vaictl 作業終止作業。

Vertex AI Vision SDK

如要使用現有串流傳送要求以擷取影片資料，您必須安裝 Vertex AI Vision SDK。

進行下列變數替換：

  • PROJECT_ID：您的 Google Cloud 專案 ID。
  • LOCATION_ID：您的位置 ID。例如：us-central1。瞭解詳情。支援的地區。
  • LOCAL_FILE.EXT：本機影片檔案的檔案名稱。例如：my-video.mp4。
  • STREAM_ID：您在叢集中建立的串流 ID。例如 input-1。
  • RTSP_ADDRESS：即時串流通訊協定 (RTSP) 動態消息的地址。例如：rtsp://my-ip-camera。

本機影片資料：

# This command streams a video file to a stream. Streaming ends when the video ends.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send video-file to streams STREAM_ID --file-path LOCAL_FILE.EXT

本機影片資料 (重複播放)：

# This command streams a video file to a stream. Video is looped into the stream until you stop the command.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send video-file to streams STREAM_ID --file-path LOCAL_FILE.EXT --loop

即時串流通訊協定 (RTSP) 動態饋給資料：

# This command will send an RTSP feed into the stream.
# This command has to run in the network that has direct access to the RTSP feed.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send rtsp to streams STREAM_ID --rtsp-uri RTSP_ADDRESS

播放攝入的影片

建立串流並將影片內容傳送至串流後，即可播放影片內容。

如果您將串流檢視分頁開啟超過一小時，必須重新整理頁面才能繼續載入影片內容。

控制台

在 Google Cloud 控制台中播放已攝入的影片。

  1. 開啟 Vertex AI Vision 資訊主頁的「Streams」分頁。

    前往「串流」分頁

  2. 在串流清單中按一下串流名稱。

  3. 在影片串流詳細資料頁面中，系統會自動載入攝入的影片即時檢視畫面。