テキストロゴの検出方法

[アーティクル]
03/23/2024

重要

Azure Media Services の提供終了の発表により、Azure AI Video Indexer は Azure AI Video Indexer の機能の調整を発表します。 Azure AI Video Indexer アカウントの意味を理解するには、Azure Media Service (AMS) の提供終了に関連する変更に関するページを参照してください。 AMS 提供終了の準備: VI の更新と移行に関するガイドを参照してください。

Note

テキストロゴ検出 (プレビュー) 作成プロセスは、現在 API 経由で利用可能です。この結果は、Azure AI Video Indexer の Web サイトで見ることができます。

テキストロゴ検出 の分析情報は、特定の定義済みテキストと一致する光学式文字認識 (OCR) テキスト検出に基づいています。

たとえば、テキストロゴ "Microsoft" を作成した場合、"Microsoft" という単語の外観が Microsoft ロゴとして検出されます。ロゴのバリエーションは異なる場合があります。これらのバリエーションは、メインロゴ名に関連付けることができます。たとえば、"Microsoft" ロゴの下には、"MS"、"MSFT" などのバリエーションがあるとします。

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

前提条件

Azure Video Index アカウントには、少なくともリソースに contributor 割り当てられているロールが必要です。

使用方法

テキストロゴ検出を使用するには、この記事に記載された次の手順に従ってください。

(バリエーションのある) Create logo API を使用してロゴインスタンスを作成します。
- ロゴ ID を保存します。
Create Logo Group API を使用してロゴグループを作成します。
- 新しいグループを作成するときに、ロゴインスタンスをグループに関連付けます (ロゴの配列に ID を貼り付けます)。
[高度なビデオ] または [高度なビデオとオーディオ] プリセットを使用してビデオをアップロードし、logoGroupId パラメーターを使用してビデオをインデックス化するロゴグループを指定します。

ロゴインスタンスを作成する

Create logo API を使用してロゴを作成します。 試してみるボタンを使用できます。

この例では、既定として指定された例を使用します。

次のパラメーターを挿入します。

Location: Azure AI Video Indexer アカウントの場所。
Account ID: Azure AI Video Indexer アカウントの ID。
Access token:トークン (少なくとも共同作成者レベルのアクセス許可)。

既定値は次のとおりです。

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

キー	値
名前	Azure AI Video Indexer Web サイトで使用されるロゴの名前。
wikipediaSearchTerm	Video Indexer Web サイトで説明を作成するために使用される用語。
text	モデルが比較に使用するテキスト。バリエーションの一部として、わかりやすい名前を必ず追加してください。 (例: Microsoft)
caseSensitive	テキストで大文字と小文字が区別されるかどうかを判断します。バリエーションに応じて true/false に設定します。

この応答では [201 作成済み] を返す必要があります。

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"
    }]
}

新しいテキストロゴグループを作成する

Create Logo Group API を使用してロゴグループを作成します。 試してみるボタンを使用します。

次のパラメーターを挿入します。

Location: Azure AI Video Indexer アカウントの場所。
Account ID: Azure AI Video Indexer アカウントの ID。
Access token:トークン (少なくとも共同作成者レベルのアクセス許可)。

[本文] に、前の手順のロゴ ID を貼り付けます。

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

既定の例には、2 つのロゴ ID があります。最初のグループは、1 つのロゴ ID のみを使用して作成されました。

この応答では [201 作成済み] を返す必要があります。

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 Video Indexer アカウントの場所
Account: Azure AI Video Indexer アカウントの ID
Name: インデックスを作成するメディアファイルの名前
Language: . en-US 詳細については、「言語サポート」を参照してください。
IndexingPreset:[Advanced Video/Audio+video]\(詳細ビデオ/オーディオ+ビデオ\) を選択 します
Videourl: URL
LogoGroupID: ロゴグループを表す GUID (作成時に応答で取得しました)
Access token: トークン(少なくとも共同作成者レベルのアクセス許可)

出力を確認する

テキスト形式のロゴモデルで一致が見つかると仮定すると、Azure AI Video Indexer Web サイトで結果を表示できます。

分析情報

インサイトパネルに新しいセクションが表示され、検出されたカスタムロゴの数が表示されます。新しいロゴを表す代表的なサムネイルが 1 つ表示されます。

タイムライン

タイムライン表示に切り替えたら、[表示] の下にある [ロゴ] チェックボックスをオンにします。検出されたすべてのサムネイルは、タイムスタンプに従って表示されます。

80% を超える確実性で認識されたすべてのロゴインスタンスが表示されます。低い確実性検出を含む検出の拡張リストは、Artifacts ファイルで入手できます。

既存のロゴグループにロゴを追加する

この記事の最初の部分では、ロゴグループの作成時にロゴのインスタンスが 1 つあり、適切なロゴグループに関連付けられています。ロゴグループが作成される前にすべてのロゴインスタンスが作成されている場合、作成フェーズでロゴグループに関連付けることができます。ただし、グループが既に作成されている場合は、次の手順に従って新しいインスタンスをグループに関連付ける必要があります。

ロゴを作成します。
1. ロゴ ID をコピーします。
ロゴグループを取得します。
1. 正しいグループのロゴグループ ID をコピーします。
ロゴグループを取得します。
1. 次のロゴ ID の一覧への応答をコピーします。
ロゴの一覧のサンプルは以下のとおりです。
```
"logos": [{
    "logoId": "id"
}],
```
ロゴグループを更新します。
1. ロゴグループ ID は、手順 2 で受け取る出力です。
2. 要求の ‘本文’ で、手順 3 からロゴの既存の一覧を貼り付けます。
3. 次に、手順 1 のロゴ ID を一覧に追加します。
[ロゴグループの更新] の応答を検証し、一覧に以前の ID と新しい ID が含まれていることを確認します。

追加情報と制限

ロゴグループには最大 50 個のロゴを含めることができます。
1 つのロゴを複数のグループにリンクさせることができます。
[ロゴグループの更新] を使用して、新しいロゴを既存のグループに追加します。

テキストロゴの検出方法

前提条件

使用方法

ロゴインスタンスを作成する

新しいテキストロゴグループを作成する

URL からのアップロード

出力を確認する

分析情報

タイムライン

既存のロゴグループにロゴを追加する

追加情報と制限

フィードバック

フィードバック

その他のリソース

テキスト ロゴの検出方法

前提条件

使用方法

ロゴ インスタンスを作成する

新しいテキスト ロゴ グループを作成する

URL からのアップロード

出力を確認する

分析情報

タイムライン

既存のロゴ グループにロゴを追加する

追加情報と制限

フィードバック

フィードバック

その他のリソース

テキストロゴの検出方法

ロゴインスタンスを作成する

新しいテキストロゴグループを作成する

既存のロゴグループにロゴを追加する