如何偵測文字標誌

2025-05-30

注意

文字標誌偵測建立程式目前可透過 API 取得。結果可以透過 Azure AI Video Indexer 網站來檢視。

文字標誌偵測 見解是以光學字元辨識（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 Video Indexer 帳戶的位置。
Account ID：Azure AI Video Indexer 帳戶的識別碼。
Access token：Token（權杖），至少需具備參與者級別權限。

預設主體為：

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

鑰匙	價值
名稱	Azure AI 影片索引器網站中使用的標誌名稱。
維基百科搜索詞	用來在影片索引器網站中建立描述的詞彙。
文字	模型用於比較的文字。請務必將明顯的名稱新增為變體的一部分。例如，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 Video Indexer 帳戶的位置。
Account ID：Azure AI Video Indexer 帳戶的識別碼。
Access token：Token（權杖），至少需具備參與者級別權限。

在本體中，貼上上一個步驟的標誌識別碼。

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

默認範例有兩個標誌標識碼。第一個群組是以一個標誌ID建立的。

回應應傳回 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：網址
LogoGroupID：代表標誌群組的 GUID（在建立標誌群組時的回應中您已取得該 GUID）
Access token：至少具有參與者層級許可權的令牌

檢查輸出

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

洞察

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

時間軸

當切換至【時間表】檢視時，在【檢視】下勾選【Logo】核取方塊。所有偵測到的縮圖都會根據其時間戳顯示。

顯示所有辨識確定性超過 80% 的標誌實例。在 Artifacts 檔案中提供擴充的偵測清單，包括低確定性偵測。

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

在本文的第一部分中，有一個標誌實例在標誌群組建立時被正確地分配到相應的標誌群組。如果所有徽標執行個體是在徽標群組創建之前創建的，則可以在創建階段將它們與徽標群組關聯起來。不過，如果已建立群組，則應遵循下列步驟將新的執行個體與群組建立關聯：

建立標誌。
1. 複製標誌識別碼。
取得商標群組。
1. 複製右邊群組的標誌群組識別碼。
獲取標誌群組。
1. 複製標誌識別碼清單的回應：
標誌清單範例：
```
"logos": [{
    "logoId": "id"
}],
```
更新標誌群組。
1. 標誌群組 ID 是第 2 步所得到的輸出。
2. 在要求的主體中，張貼步驟 3 中現有的標誌列表。
3. 然後將步驟 1 中的標誌識別碼新增到清單中。
驗證更新標誌群組的回應，確保清單包含先前識別碼和新識別碼。

其他資訊和限制

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