如何检测文本徽标

项目
03/26/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 具有分配给资源的角色。

如何使用

若要使用文本徽标检测，请按照本文中所述的步骤操作：

使用 Create 徽标 API 创建徽标实例（具有变体）。
- 保存徽标 ID。
使用 “创建徽标组 API”创建徽标组。
- 创建新组时，将徽标实例与组相关联（通过粘贴徽标数组中的 ID）。
使用：高级视频或高级视频 + 音频预设上传视频，使用logoGroupId参数指定要为视频编制索引的徽标组。

创建徽标实例

使用“创建徽标 API”创建徽标。可以使用试用按钮。

在此示例中，我们使用默认提供的示例：

插入以下参数：

Location：Azure AI 视频索引器帐户的位置。
Account ID：Azure AI 视频索引器帐户的 ID。
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 视频索引器帐户的 ID。
Access token：令牌，至少是参与者级别权限。

在正文中粘贴上一步中的徽标 ID。

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

默认示例有两个徽标 ID。第一个组仅创建一个徽标 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 视频索引器帐户的 ID
Name：要编制索引的媒体文件的名称
Language： en-US. 有关详细信息，请参阅语言支持。
IndexingPreset：选择“高级视频/音频+视频”
Videourl：URL
LogoGroupID：表示徽标组的 GUID（创建徽标组时在响应中获取）
Access token：令牌，至少是参与者级别权限

检查输出

假设文本徽标模型找到匹配项，则可以在 Azure AI 视频索引器网站中查看结果。

洞察力

“见解”面板中将显示一个新部分，其中显示了检测到的自定义徽标数。将显示一个代表新徽标的代表缩略图。

时间线

切换到时间线视图时，在“视图”下，标记徽标检查框。所有检测到的缩略图都根据其时间戳显示。

将显示通过 80% 以上特定程度识别的所有徽标实例。项目文件中提供了检测的扩展列表，包括低确定性检测。

将徽标添加到现有徽标组

本文的第一部分是徽标的一个实例，并在创建徽标组时关联到正确的徽标组。如果在创建徽标组之前创建了所有徽标实例，则可以在创建阶段与徽标组相关联。但是，如果已创建组，则应按照以下步骤将新实例关联到该组：

创建徽标。
1. 复制徽标 ID。
获取徽标组。
1. 复制右侧组的徽标组 ID。
获取徽标组。
1. 复制徽标 ID 列表的响应：
徽标列表示例：
```
"logos": [{
    "logoId": "id"
}],
```
更新徽标组。
1. 徽标组 ID 是步骤 2 收到的输出。
2. 在请求的“正文”处，粘贴步骤 3 中的现有徽标列表。
3. 然后添加到步骤 1 中的徽标 ID 列表。
验证更新徽标组的响应，确保列表包含以前的 ID 和新 ID。

其他信息和限制

徽标组最多可以包含 50 个徽标。
一个徽标可以链接到多个组。
使用更新徽标组将新徽标添加到现有组。