具有 ARM 型 VI 帳戶的 Logic Apps 連接器

重要

由於 Azure 媒體服務 淘汰公告，Azure AI 影片索引器會宣告 Azure AI 影片索引器功能調整。 請參閱 Azure 媒體服務 （AMS） 淘汰 的相關變更，以瞭解 Azure AI 影片索引器帳戶的意義。 請參閱準備AMS淘汰：VI更新和移轉指南。

Azure AI 影片索引器 （VI） REST API 支援伺服器對伺服器和客戶端對伺服器通訊。 API 可讓您將視訊和音訊深入解析整合到應用程式邏輯中。

提示

如需最新的 api-version，請在 REST 檔中選擇最新的穩定版本。

為了簡化整合，我們支援 與 Azure AI 影片索引器 API 相容的 Logic Apps 和 Power Automate 連接器。

您可以使用連接器來設定自定義工作流程，以有效地編製和擷取大量視訊和音訊檔案的見解，而不需撰寫單行程序代碼。 此外，使用連接器進行整合可讓您更清楚瞭解工作流程的健康情況，以及偵錯工作流程的簡單方式。

提示

如果您使用傳統 VI 帳戶，請參閱 具有傳統型 VI 帳戶的 Logic Apps 連接器。

開始使用 Azure AI 影片索引器連接器

為了協助您快速開始使用 Azure AI 影片索引器連接器，本文中的範例會建立邏輯應用程式流程。 邏輯應用程式和Power Automate 功能及其編輯器幾乎完全相同，因此圖表和說明都適用於兩者。 本文中的範例是以 ARM VI 帳戶為基礎。 如果您使用傳統帳戶，請參閱使用傳統型 VI 帳戶的邏輯 應用程式連線程式。

本文所涵蓋的「自動上傳和編製影片索引」案例是由兩個不同的流程所組成，可一起運作。 「兩個流程」方法可用來有效支援大型檔案的異步上傳和編製索引。

• 第一個流程會在 Azure 儲存體 帳戶中新增或修改 Blob 時觸發。 它會使用回呼 URL 將新檔案上傳至 Azure AI 影片索引器，以在編製索引作業完成後傳送通知。
• 第二個流程會根據回呼 URL 觸發，並將擷取的深入解析儲存回 Azure 儲存體 中的 JSON 檔案。

您在本文中建立的邏輯應用程式，每個應用程式都包含一個流程。 第二節（建立類型耗用量的新邏輯應用程式）說明如何連接兩者。 第二個流程是獨立的，由第一個流程觸發（具有回呼 URL 的區段）。

必要條件

• 如果您沒有 Azure 訂用帳戶，請在開始之前先建立 Azure 免費帳戶。

• 建立以ARM為基礎的 Azure AI 影片索引器帳戶。

• 建立 Azure 儲存體帳戶。 請記下 儲存體 帳戶的存取金鑰。

  建立兩個容器：一個用來儲存媒體檔案，二是儲存 Azure AI 影片索引器所產生的深入解析。 在本文中，容器是 videos 和 insights。

設定檔案上傳流程 （第一個流程）

本節說明如何設定第一個 （“檔案上傳”） 流程。 第一個流程會在 Azure 儲存體 帳戶中新增或修改 Blob 時觸發。 它會使用回呼 URL 將新檔案上傳至 Azure AI 影片索引器，以在編製索引作業完成後傳送通知。

下圖顯示第一個流程：

1. 建立邏輯應用程式。 我們會在與 Azure 影片索引器區域相同的區域中建立邏輯應用程式（建議但不需要）。 我們呼叫邏輯應用程式 UploadIndexVideosApp。

   1. 針對 [方案類型] 選取 [取用]。
   2. 按 [檢閱 + 建立 ] ->Create。
   3. 邏輯應用程式部署完成後，請在 Azure 入口網站 中搜尋並流覽至新建立的邏輯應用程式。
   4. 在 [設定] 區段的左側面板中，選取 [身分識別] 索引標籤。
   5. 在 [系統指派] 下，將 [狀態] 從 [關閉] 變更為 [開啟] （本教學課程稍後的步驟很重要）。
   6. 按 [儲存 ] （在頁面頂端）。
   7. 選取左側窗格中的 [ 邏輯應用程式設計工具 ] 索引標籤。
   8. 挑選空白 邏輯應用程式 流程。
   9. 在 [選擇作業] 刀鋒視窗中搜尋 “blob”。
   10. 在 [所有] 索引標籤中，選擇 Azure Blob 儲存體元件。
   11. 在 [觸發程式] 底下，選取 [新增或修改 Blob 時] （僅限屬性） （V2） 觸發程式。

2. 設定記憶體連線。

   建立 當新增或修改 Blob （僅限屬性） （V2） 觸發程式之後，連線必須設定為下列值：

   機碼	值
   連線名稱	<為您的連線>命名。
   驗證類型	便捷鍵
   Azure 儲存體 帳戶名稱	<儲存體 要儲存>媒體檔案的帳戶名稱。
   Azure 儲存體 帳戶存取金鑰	若要取得記憶體帳戶的存取金鑰：請在 [安全性 + 網络功能 -> 存取金鑰] 下的 [Azure 入口網站 ->> my-storage -> 複製其中一個密鑰。

   選取 建立。

   

   設定記憶體的連線之後，必須指定要監視變更的 Blob 記憶體容器。

   機碼	值
   儲存體帳戶名稱	儲存體 儲存媒體檔案的帳戶名稱
   容器	/videos

   選取 [ 儲存 ] ->+[新增步驟]

   

3. 依路徑動作建立 SAS URI。

   1. 選取 [動作] 索引標籤。
   2. 搜尋並選取 [依路徑建立 SAS URI][V2]。

   機碼	值
   儲存體帳戶名稱	<儲存媒體檔案>的記憶體帳戶名稱。
   Blob 路徑	在 [動態內容] 底下，選取 [檔案路徑清單]
   組策略標識碼	保留預設值。
   權限	讀取
   共用存取通訊協定 （在按 [新增參數] 之後出現）	HttpsOnly

   選取 [ 儲存 ] （頁面頂端）。

   

   選取 [+新增步驟]。

4. 產生存取令牌。

   注意

   如需 ARM API 和要求/回應範例的詳細資訊，請參閱 產生 Azure AI 影片索引器存取令牌。

   按 [試試看] 以取得帳戶的正確值。

   搜尋並建立 HTTP 動作。

   機碼	值	備註
   方法	POST
   URI	generateAccessToken。
   本文	{ "permissionType": "Contributor", "scope": "Account" }	請參閱 REST 檔範例，請務必刪除 POST 行。
   新增參數	驗證

   

   新增驗證參數之後，請根據下表填入必要的參數：

   機碼	值
   驗證類型	受控識別
   受控識別	系統指派的受控識別
   對象	https://management.core.windows.net

   選取 [儲存]。

   提示

   移至下一個步驟之前，請先設定邏輯應用程式與 Azure AI 影片索引器帳戶之間的正確許可權。

   請確定您已遵循步驟來啟用 Logic Apps 的系統指派受控識別。

   

   1. 設定系統指派的受控識別，以取得 Azure AI 影片索引器資源的許可權。

      在 Azure 入口網站 中，移至您的 Azure AI 影片索引器資源/帳戶。

      1. 在左側刀鋒視窗上，然後選取 [ 訪問控制]。
      2. 選取 [新增>角色指派 -> 參與者 - 下一步 ->> 使用者、群組或服務主體 ] ->+[選取成員]。
      3. 在 [成員] 底下，搜尋您建立的Logic Apps 名稱（在此案例中為 UploadIndexVideosApp）。
      4. 按 [選取]。
      5. 按 [ 檢閱 + 指派]。

5. 回到邏輯應用程式中，建立 上傳影片和索引 動作。

   1. 選取 [影片索引器][V2]。

   2. 從影片索引器（V2），選取 [ 上傳影片和索引]。

   3. 設定影片索引器帳戶的連線。

      機碼	值
      連線名稱	<在此案例aviconnection中，輸入連接>的名稱。
      API 金鑰	這是您的個人 API 金鑰，可在開發人員入口網站中的 [配置檔] 下取得，因為此邏輯應用程式適用於 ARM 帳戶，所以我們不需要實際的 API 密鑰，而且您可以填入虛擬值，例如 12345

      選取 建立。

   4. 填入 上傳影片和索引 動作參數。

      提示

      如果找不到 VI 帳戶識別碼且不在下拉式清單中，請使用自定義值。

      機碼	值
      Location	相關聯的 Azure AI 影片索引器帳戶位置。
      帳戶識別碼	相關聯 Azure AI 影片索引器帳戶的帳戶標識碼。 您可以在帳戶的 [概觀] 頁面中，於 Azure 入口網站 中找到帳戶標識碼。 或者，Azure AI 影片索引器網站的左側 [帳戶設定] 索引標籤。
      存取權杖	body('HTTP')['accessToken']使用 表達式，從先前的 HTTP 呼叫中，以正確的格式擷取存取令牌。
      影片名稱	從新增或修改 Blob 動作的動態內容選取 [檔案名清單]。
      影片 URL	從 [依路徑建立 SAS URI] 動作的動態內容選取 [Web URL]。
      本文	可以保留為預設值。

      

      選取 [儲存]。

從第一個流程上傳和編製索引的完成，將會傳送 HTTP 要求，並提供正確的回呼 URL 來觸發第二個流程。 然後，它會擷取 Azure AI 影片索引器所產生的深入解析。 在此範例中，它會將索引作業的輸出儲存在 Azure 儲存體 中。 不過，您必須對輸出執行作業。

建立類型耗用量的新邏輯應用程式 （第二個流程）

建立第二個流程，類型耗用量的LogicApps。 第二個流程會根據回呼 URL 觸發，並將擷取的深入解析儲存回 Azure 儲存體 中的 JSON 檔案。

1. 設定觸發程式

   搜尋收到 HTTP 要求時。

   

   針對觸發程式，我們將會看到 [HTTP POST URL] 字段。 在您儲存流程之後，才會產生URL;不過，您最終需要URL。

   提示

   我們將回到此步驟中建立的URL。

2. 產生存取令牌。

   請遵循下列所有步驟：

   1. 產生我們對第一個流程所做的存取令牌 （如下所示）。
   2. 選取 [儲存] ->+ [新增步驟]。

3. 取得影片索引器深入解析。

   1. 搜尋「影片索引器」。

   2. 從 影片索引器（V2）選取 [ 取得影片索引] 動作。

      設定連線名稱：

      機碼	值
      連線名稱	<連接>的名稱。 例如： aviconnection 。
      API 金鑰	這是您的個人 API 金鑰，可在開發人員入口網站的 [配置檔] 下取得。 如需詳細資訊，請參閱 訂閱 API。

      1. 選取 建立。

   3. 根據資料表填寫必要的參數：

      機碼	值
      Location	Azure AI 影片索引器帳戶的位置。
      帳戶識別碼	影片索引器帳戶標識碼可以從 Azure 入口網站 中的 [資源/帳戶概觀] 頁面複製。
      視訊標識碼*	針對影片標識碼，新增Expression類型的動態內容，並放入下列表達式：triggerOutputs（）['queries']['id']。
      存取權杖	從動態內容中，在 [剖析 JSON] 區段底下，選取 accessToken，這是剖析 JSON 動作的輸出。

      *此表達式會告知連接者從觸發程序的輸出取得視訊標識符。 在此情況下，觸發程式的輸出將會是第一個觸發程式中上傳影片和索引的輸出。

      

      選取 [儲存] ->+ [新增步驟]。

4. 建立 Blob 並儲存深入解析 JSON。

   1. 從動作群組搜尋 「Azure Blob」。

   2. 選取 [ 建立 Blob（V2）]。

   3. 設定將儲存 JSON 深入解析檔案之 Blob 記憶體的連線。

      機碼	值
      連線名稱	<輸入連線名稱>。
      驗證類型	便捷鍵
      Azure 儲存體 帳戶名稱	<* 將儲存深入解析的記憶體帳戶名稱*>。
      Azure 儲存體 帳戶存取金鑰	移至 [安全性 + 網络 ] ->[存取金鑰] 底下的 [Azure 入口網站-> my-storage> -> 複製其中一個密鑰。

      

   4. 選取 建立。

   5. 設定將儲存深入解析的資料夾。

      機碼	值
      儲存體帳戶名稱	<輸入包含 JSON 輸出的記憶體帳戶名稱（在本教學課程中與來源影片相同）。>
      Folder path	從下拉式清單中選取 /insights
      Blob 名稱	從動態內容中，在 [ 取得影片索引 ] 區段底下選取 [名稱 ] 並新增 _insights.json，[深入解析檔名] 會是影片名稱 + insights.json
      Blob 內容	從動態內容中，選取 [取得影片索引] 區段底下的 [本文]。

      

   6. 選取 [ 儲存流程]。

5. 更新回呼 URL，以在索引作業完成時收到通知。

   儲存流程之後，就會在觸發程式中建立 HTTP POST URL。

   1. 從觸發程式複製 URL。

      

   2. 返回第一個流程，並在回呼 URL 參數的上傳影片和索引動作中貼上 URL。

請確定已儲存這兩個流程。