Rychlý start: Použití klientské knihovny Vyhledávání videí Bingu

Článek
10/22/2020

Upozornění

30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API Bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingu najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.

Pomocí tohoto rychlého startu můžete začít vyhledávat novinky pomocí klientské knihovny Bingu pro vyhledávání videí pro jazyk C#. Vyhledávání videí Bingu má rozhraní REST API kompatibilní s většinou programovacích jazyků, ale klientská knihovna poskytuje snadný způsob integrace služby do vašich aplikací. Zdrojový kód pro tuto ukázku najdete na GitHubu s dalšími poznámkami a funkcemi.

Požadavky

Libovolná edice sady Visual Studio 2017 nebo novější.
Rozhraní Json.NET, které je k dispozici jako balíček NuGet.

Pokud chcete do svého projektu přidat klientskou knihovnu Vyhledávání videí Bingu, vyberte Spravovat balíčky NuGet z Průzkumník řešení v sadě Visual Studio. Přidejte balíček Microsoft.Azure.CognitiveServices.Search.VideoSearch.

Instalace [balíčku NuGet Video Search SDK] také nainstaluje následující závislosti:

Microsoft.Rest.ClientRuntime
Microsoft.Rest.ClientRuntime.Azure
Newtonsoft.Json

Vytvoření prostředku Azure

Začněte používat rozhraní API Bingu pro vyhledávání videí vytvořením jednoho z následujících prostředků Azure:

prostředek Vyhledávání Bingu v7

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
K vyzkoušení služby použijte bezplatnou cenovou úroveň a později ji upgradujte na placenou úroveň pro produkční prostředí.

Prostředek s více službami

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
Pro své aplikace použijte stejný klíč a koncový bod napříč několika službami Azure AI.

Vytvoření a inicializace projektu

Vytvořte nové řešení konzoly jazyka C# v sadě Visual Studio. Pak do hlavního souboru kódu přidejte následující kód.

using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.Azure.CognitiveServices.Search.VideoSearch;
using Microsoft.Azure.CognitiveServices.Search.VideoSearch.Models;

Vytvořte instanci klienta vytvořením nového ApiKeyServiceClientCredentials objektu s klíčem předplatného a zavoláním konstruktoru.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Odeslání požadavku hledání a zpracování výsledků

Pomocí klienta odešlete žádost o hledání. Pro vyhledávací dotaz použijte SwiftKey.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Pokud se vrátily nějaké výsledky, získejte první z nich pomocí videoResults.Value[0]příkazu . Pak vytiskněte ID, název a adresu URL videa.

if (videoResults.Value.Count > 0)
{
    var firstVideoResult = videoResults.Value[0];

    Console.WriteLine($"\r\nVideo result count: {videoResults.Value.Count}");
    Console.WriteLine($"First video id: {firstVideoResult.VideoId}");
    Console.WriteLine($"First video name: {firstVideoResult.Name}");
    Console.WriteLine($"First video url: {firstVideoResult.ContentUrl}");
}
else
{
    Console.WriteLine("Couldn't find video results!");
}

Další kroky

Vytvoření jednostránkové webové aplikace

Viz také

Pomocí tohoto rychlého startu můžete začít vyhledávat novinky pomocí klientské knihovny Vyhledávání videí Bingu pro Javu. Vyhledávání videí Bingu má rozhraní REST API kompatibilní s většinou programovacích jazyků, ale klientská knihovna poskytuje snadný způsob integrace služby do vašich aplikací. Zdrojový kód pro tuto ukázku najdete na GitHubu s dalšími poznámkami a funkcemi.

Požadavky

Vytvoření prostředku Azure

Začněte používat rozhraní API Bingu pro vyhledávání videí vytvořením jednoho z následujících prostředků Azure:

prostředek Vyhledávání Bingu v7

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
K vyzkoušení služby použijte bezplatnou cenovou úroveň a později ji upgradujte na placenou úroveň pro produkční prostředí.

Prostředek s více službami

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
Pro své aplikace použijte stejný klíč a koncový bod napříč několika službami Azure AI.

Nainstalujte závislosti klientské knihovny Vyhledávání videí Bingu pomocí Mavenu, Gradle nebo jiného systému pro správu závislostí. Soubor POM Mavenu vyžaduje následující deklaraci:

  <dependencies>
    <dependency>
      <groupId>com.microsoft.azure.cognitiveservices</groupId>
      <artifactId>azure-cognitiveservices-videosearch</artifactId>
      <version>0.0.1-beta-SNAPSHOT</version>
    </dependency>
  </dependencies>

Vytvoření a inicializace projektu

V oblíbeném integrovaném vývojovém prostředí nebo editoru vytvořte nový projekt Java a naimportujte následující knihovny.

    import com.microsoft.azure.cognitiveservices.videosearch.*;
    import com.microsoft.azure.cognitiveservices.videosearch.VideoObject;
    import com.microsoft.rest.credentials.ServiceClientCredentials;
    import okhttp3.Interceptor;
    import okhttp3.OkHttpClient;
    import okhttp3.Request;
    import okhttp3.Response;
    import java.io.IOException;
    import java.util.ArrayList;
    import java.util.List;

Vytvoření klienta vyhledávací služby

VideoSearchAPIImpl Implementujte klienta, který vyžaduje koncový bod rozhraní API, a instanci ServiceClientCredentials třídy .

public static VideoSearchAPIImpl getClient(final String subscriptionKey) {
    return new VideoSearchAPIImpl("https://api.cognitive.microsoft.com/bing/v7.0/",
            new ServiceClientCredentials() {
            //...
            }
)};

Pokud chcete implementovat ServiceClientCredentials, postupujte takto:

přepsání applyCredentialsFilter() funkce s objektem OkHttpClient.Builder jako parametrem.

//...
new ServiceClientCredentials() {
        @Override
        public void applyCredentialsFilter(OkHttpClient.Builder builder) {
        //...
        }
//...

V rámci applyCredentialsFilter()volejte builder.addNetworkInterceptor(). Vytvořte nový Interceptor objekt a přepište jeho intercept() metodu tak, aby převzala objekt zachytávacího objektu Chain .
```
//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...
```

V rámci intercept funkce vytvořte proměnné pro váš požadavek. Použijte Request.Builder() k sestavení žádosti. Přidejte klíč předplatného do hlavičky Ocp-Apim-Subscription-Key a vraťte se chain.proceed() k objektu požadavku.

//...
public Response intercept(Chain chain) throws IOException {
    Request request = null;
    Request original = chain.request();
    Request.Builder requestBuilder = original.newBuilder()
            .addHeader("Ocp-Apim-Subscription-Key", subscriptionKey);
    request = requestBuilder.build();
    return chain.proceed(request);
}
//...

Odeslání požadavku hledání a přijetí odpovědi

Vytvořte funkci s názvem VideoSearch() , která převezme klíč předplatného jako řetězec. Vytvořte instanci dříve vytvořeného klienta vyhledávání.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

V nástroji VideoSearch()odešlete žádost o vyhledání videa pomocí klienta s hledaným termínem SwiftKey . Pokud rozhraní API pro vyhledávání videí vrátilo výsledek, získejte první výsledek a vytiskněte jeho ID, název a adresu URL spolu s celkovým počtem vrácených videí.

VideosInner videoResults = client.searchs().list("SwiftKey");

if (videoResults == null){
    System.out.println("Didn't see any video result data..");
}
else{
    if (videoResults.value().size() > 0){
        VideoObject firstVideoResult = videoResults.value().get(0);

        System.out.println(String.format("Video result count: %d", videoResults.value().size()));
        System.out.println(String.format("First video id: %s", firstVideoResult.videoId()));
        System.out.println(String.format("First video name: %s", firstVideoResult.name()));
        System.out.println(String.format("First video url: %s", firstVideoResult.contentUrl()));
    }
    else{
        System.out.println("Couldn't find video results!");
    }
}

Zavolejte metodu hledání z hlavní metody.

public static void main(String[] args) {
    VideoSDK.VideoSearch("YOUR-SUBSCRIPTION-KEY");
}

Další kroky

Vytvoření jednostránkové webové aplikace

Viz také

Pomocí tohoto rychlého startu můžete začít vyhledávat novinky pomocí klientské knihovny Vyhledávání videí Bingu pro JavaScript. Vyhledávání videí Bingu má rozhraní REST API kompatibilní s většinou programovacích jazyků, ale klientská knihovna poskytuje snadný způsob integrace služby do vašich aplikací. Zdrojový kód pro tuto ukázku najdete na GitHubu. Obsahuje více poznámek a funkcí.

Požadavky

Nejnovější verze Node.js
Sada SDK Bingu pro vyhledávání videí pro JavaScript
- Instalaci provedete spuštěním příkazu . npm install @azure/cognitiveservices-videosearch
Třída CognitiveServicesCredentials z @azure/ms-rest-azure-js balíčku k ověření klienta.
- Instalaci provedete spuštěním příkazu . npm install @azure/ms-rest-azure-js

Vytvoření prostředku Azure

Začněte používat rozhraní API Bingu pro vyhledávání videí vytvořením jednoho z následujících prostředků Azure:

prostředek Vyhledávání Bingu v7

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
K vyzkoušení služby použijte bezplatnou cenovou úroveň a později ji upgradujte na placenou úroveň pro produkční prostředí.

Prostředek s více službami

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
Pro své aplikace použijte stejný klíč a koncový bod napříč několika službami Azure AI.

Vytvoření a inicializace aplikace

Ve svém oblíbeném integrovaném vývojovém prostředí nebo editoru vytvořte nový soubor JavaScriptu a přidejte require() příkaz pro klientskou knihovnu a CognitiveServicesCredentials modul Vyhledávání videí Bingu. Vytvořte proměnnou pro klíč předplatného.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Vytvořte instanci s CognitiveServicesCredentials klíčem . Pak ho použijte k vytvoření instance klienta vyhledávání videí.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

Odeslání žádosti o hledání

Slouží client.videosOperations.search() k odeslání žádosti o vyhledávání do rozhraní API Bingu pro vyhledávání videí. Když se vrátí výsledky hledání, použijte .then() k protokolování výsledku.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Další kroky

Vytvoření jednostránkové webové aplikace

Viz také

Pomocí tohoto rychlého startu můžete začít vyhledávat novinky pomocí klientské knihovny Bingu pro vyhledávání videí pro Python. Vyhledávání videí Bingu má rozhraní REST API kompatibilní s většinou programovacích jazyků, ale klientská knihovna poskytuje snadný způsob integrace služby do vašich aplikací. Zdrojový kód pro tuto ukázku najdete na GitHubu s dalšími poznámkami a funkcemi.

Vytvoření prostředku Azure

Začněte používat rozhraní API Bingu pro vyhledávání videí vytvořením jednoho z následujících prostředků Azure:

prostředek Vyhledávání Bingu v7

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
K vyzkoušení služby použijte bezplatnou cenovou úroveň a později ji upgradujte na placenou úroveň pro produkční prostředí.

Prostředek s více službami

K dispozici prostřednictvím Azure Portal, dokud prostředek neodstraníte.
Pro své aplikace použijte stejný klíč a koncový bod napříč několika službami Azure AI.

Požadavky

Python 2.x nebo 3.x
Klientská knihovna Vyhledávání videí Bingu pro Python

Doporučuje se používat virtuální prostředí Pythonu. Virtuální prostředí můžete nainstalovat a inicializovat pomocí modulu venv. Nainstalujte virtualenv pro Python 2.7 pomocí:

python -m venv mytestenv

Nainstalujte klientskou knihovnu Vyhledávání videí Bingu pomocí:

cd mytestenv
python -m pip install azure-cognitiveservices-search-videosearch

Vytvoření a inicializace aplikace

Ve svém oblíbeném integrovaném vývojovém prostředí nebo editoru vytvořte nový soubor Pythonu a přidejte následující příkazy pro import.

from azure.cognitiveservices.search.videosearch import VideoSearchClient
from azure.cognitiveservices.search.videosearch.models import VideoPricing, VideoLength, VideoResolution, VideoInsightModule
from msrest.authentication import CognitiveServicesCredentials

Vytvořte proměnnou pro klíč předplatného.

subscription_key = "YOUR-SUBSCRIPTION-KEY"
endpoint = "YOUR-ENDPOINT"

Vytvoření klienta vyhledávací služby

Vytvořte instanci třídy CognitiveServicesCredentials a vytvořte instanci klienta:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Odeslání požadavku hledání a získání odpovědi

Pomocí client.videos.search() vyhledávacího dotazu odešlete požadavek do rozhraní API Bingu pro vyhledávání videí a získejte odpověď.
```
video_result = client.videos.search(query="SwiftKey")
```

Pokud odpověď obsahuje výsledky hledání, získejte první a vytiskněte jeho ID, název a adresu URL.

if video_result.value:
    first_video_result = video_result.value[0]
    print("Video result count: {}".format(len(video_result.value)))
    print("First video id: {}".format(first_video_result.video_id))
    print("First video name: {}".format(first_video_result.name))
    print("First video url: {}".format(first_video_result.content_url))
else:
    print("Didn't see any video result data..")

Další kroky

Vytvoření jednostránkové webové aplikace

Rychlý start: Použití klientské knihovny Vyhledávání videí Bingu

Požadavky

Vytvoření prostředku Azure

Vytvoření a inicializace projektu

Odeslání požadavku hledání a zpracování výsledků

Další kroky

Viz také

Požadavky

Vytvoření prostředku Azure

Vytvoření a inicializace projektu

Vytvoření klienta vyhledávací služby

Odeslání požadavku hledání a přijetí odpovědi

Další kroky

Viz také

Požadavky

Vytvoření prostředku Azure

Vytvoření a inicializace aplikace

Odeslání žádosti o hledání

Další kroky

Viz také

Vytvoření prostředku Azure

Požadavky

Vytvoření a inicializace aplikace

Vytvoření klienta vyhledávací služby

Odeslání požadavku hledání a získání odpovědi

Další kroky

Viz také

Další materiály