如何偵測文字標誌

發行項
03/25/2024

重要

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

注意

文字標誌偵測（預覽）建立程式目前可透過 API 取得。結果可透過 Azure AI 影片索引器網站來檢視。

文字標誌偵測 見解是以光學字元辨識（OCR）文字偵測為基礎，其符合特定預先定義的文字。

例如，如果您建立文字標誌「Microsoft」，則會偵測到「Microsoft」這個字的外觀為 Microsoft 標誌。標誌可以有不同的變化。這些變化可以與主要標誌名稱相關聯。例如，您可能在 'Microsoft' 標誌下有下列變化：'MS'、'MSFT' 等。

{
    "name": "Microsoft",
    "wikipediaSearchTerm": "Microsoft",
    "textVariations": [{
    "text": "Microsoft",
    "caseSensitive": false
    }, {
    "text": "MSFT",
    "caseSensitive": true
    }]
}

必要條件

Azure 影片索引帳戶必須至少有 contributor 指派給資源的角色。

使用方式

若要使用文字標誌偵測，請遵循本文中所述的下列步驟：

使用建立標誌 API 建立標誌實例（具有變化）。
- 儲存標誌標識碼。
使用建立標誌群組 API 建立標誌群組。
- 建立新群組時，將標誌實例與群組產生關聯（在標誌陣列中貼上標識元）。
使用：進階視訊或進階視訊 + 音訊預設上傳影片，請使用 logoGroupId 參數來指定您想要編製影片索引的標誌群組。

建立標誌實例

使用建立標誌 API 來建立您的標誌。您可以使用 試用按鈕 。

在此範例中，我們使用提供作為預設值的範例：

插入下列參數：

Location：Azure AI 影片索引器帳戶的位置。
Account ID：Azure AI 影片索引器帳戶的標識碼。
Access token：令牌，至少是參與者層級許可權。

預設主體為：

{
    "name": "Microsoft",
    "wikipediaSearchTerm": "Microsoft",
    "textVariations": [{
    "text": "Microsoft",
    "caseSensitive": false
    }, {
    "text": "MSFT",
    "caseSensitive": true
    }]
}

機碼	值
名稱	Azure AI 影片索引器網站中使用的標誌名稱。
wikipediaSearchTerm	用來在影片索引器網站中建立描述的詞彙。
text	模型用於比較的文字。請務必將明顯的名稱新增為變化的一部分。（例如 Microsoft）
caseSensitive	判斷文字是否區分大小寫。根據變化設定為 true/false。

回應應該會傳回 201 Created。

HTTP/1.1 201 Created

content-type: application/json; charset=utf-8

{
    "id": "id"
    "creationTime": "2023-01-15T13:08:14.9518235Z",
    "lastUpdateTime": "2023-01-15T13:08:14.9518235Z",
    "lastUpdatedBy": "Jhon Doe",
    "createdBy": "Jhon Doe",
    "name": "Microsoft",
    "wikipediaSearchTerm": "Microsoft",
    "textVariations": [{
        "text": "Microsoft",
        "caseSensitive": false,
        "creationTime": "2023-01-15T13:08:14.9518235Z",
        "createdBy": "Jhon Doe"
    }, {
        "text": "MSFT",
        "caseSensitive": true,
        "creationTime": "2023-01-15T13:08:14.9518235Z",
        "createdBy": "Jhon Doe"
    }]
}

建立新的文字標誌群組

使用建立標誌群組 API 來建立標誌群組。 使用試用按鈕。

插入下列參數：

Location：Azure AI 影片索引器帳戶的位置。
Account ID：Azure AI 影片索引器帳戶的標識碼。
Access token：令牌，至少是參與者層級許可權。

在本文中，貼上上一個步驟中的標誌標識符。

{
    "logos": [{
        "logoId": "id"
    }],
    "name": "Technology",
    "description": "A group of logos of technology companies."
}

默認範例有兩個標誌標識碼。第一個群組只建立一個標誌標識符。

回應應該會傳回 201 Created。

HTTP/1.1 201 Created

content-type: application/json; charset=utf-8

{
    "id": "id",
    "creationTime": "2023-01-15T14:41:11.4860104Z",
    "lastUpdateTime": "2023-01-15T14:41:11.4860104Z",
    "lastUpdatedBy": "Jhon Doe",
    "createdBy": "Jhon Doe",
    "logos": [{
        "logoId": " e9d609b4-d6a6-4943-86ff-557e724bd7c6"
    }],
    "name": "Technology",
    "description": "A group of logos of technology companies."
}

從 URL 上傳

使用上傳 API 呼叫：

指定下列參數：

Location：Azure AI 影片索引器帳戶的位置
Account：Azure AI 影片索引器帳戶的標識碼
Name：您要編制索引的媒體檔案名稱
Language： en-US。如需詳細資訊，請參閱語言支援。
IndexingPreset：選取 [ 進階視訊/音訊+視訊]
Videourl：URL
LogoGroupID：代表標誌群組的 GUID（您在建立標誌群組時在回應中取得它）
Access token：令牌，至少是參與者層級許可權

檢查輸出

假設文字標誌模型找到相符專案，您就可以在 Azure AI 影片索引器網站中檢視結果。

深入解析

新的區段會出現在深入解析面板中，其中顯示偵測到的自定義標誌數目。其中一個代表縮圖會顯示代表新的標誌。

時間軸

切換至 [時程表] 檢視時，請在 [檢視] 底下，標示 [ 標誌] 複選框。所有偵測到的縮圖都會根據其時間戳顯示。

顯示所有以 80% 以上之確定性辨識的標誌實例。成品檔案中提供偵測的擴充清單，包括低確定性偵測。

將標誌新增至現有的標誌群組

在本文的第一個部分中，在建立標誌群組時，有一個標誌實例與正確的標誌群組相關聯。如果在建立標誌群組之前建立所有標誌實例，則可以在建立階段與標誌群組建立關聯。不過，如果群組已建立，則新的實例應該遵循下列步驟與群組相關聯：

建立標誌。
1. 複製標誌標識碼。
取得標誌群組。
1. 複製正確群組的標誌群組標識碼。
取得標誌群組。
1. 複製回應標誌識別碼清單：
標誌清單範例：
```
"logos": [{
    "logoId": "id"
}],
```
更新標誌群組。
1. 標誌群組標識碼是步驟 2 所收到的輸出。
2. 在要求的 [本文] 中，貼上步驟 3 中現有的標誌清單。
3. 然後將新增至步驟 1 中的標誌標識碼清單。
驗證更新標誌群組的響應，確定清單包含先前的標識碼和新標識碼。

其他資訊和限制

標誌群組最多可包含 50 個標誌。
一個標誌可以連結至多個群組。
使用更新標誌群組，將新的標誌新增至現有的群組。