Szybki start: korzystanie z biblioteki klienta wyszukiwania wideo Bing

Artykuł
10/22/2020

Ostrzeżenie

30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest dostarczana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pomocą Azure Marketplace.

Użyj tego przewodnika Szybki start, aby rozpocząć wyszukiwanie wiadomości w bibliotece klienta wyszukiwania wideo Bing dla języka C#. Podczas gdy wyszukiwanie wideo Bing ma interfejs API REST zgodny z większością języków programowania, biblioteka kliencka zapewnia łatwy sposób integracji usługi z aplikacjami. Kod źródłowy dla tego przykładu można znaleźć w witrynie GitHub z dodatkowymi adnotacjami i funkcjami.

Wymagania wstępne

Dowolna wersja programu Visual Studio 2017 lub nowsza.
Struktura Json.NET dostępna jako pakiet NuGet.

Aby dodać bibliotekę klienta wyszukiwania wideo Bing do projektu, wybierz pozycję Zarządzaj pakietami NuGet z Eksplorator rozwiązań w programie Visual Studio. Dodaj pakiet Microsoft.Azure.CognitiveServices.Search.VideoSearch.

Zainstalowanie [zestawu NuGet Video Search SDK]spowoduje również zainstalowanie następujących zależności:

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

Tworzenie zasobu platformy Azure

Zacznij korzystać z interfejsu API wyszukiwania wideo Bing, tworząc jeden z następujących zasobów platformy Azure:

zasób Wyszukiwanie Bing w wersji 7

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj warstwy cenowej Bezpłatna, aby wypróbować usługę, a następnie uaktualnić ją do warstwy płatnej dla środowiska produkcyjnego.

Zasób z wieloma usługami

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj tego samego klucza i punktu końcowego dla aplikacji w wielu usługach azure AI.

Tworzenie i inicjowanie projektu

Utwórz nowe rozwiązanie konsolowe dla języka C# w programie Visual Studio. Dodaj następujący kod do głównego pliku kodu.

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

Utwórz wystąpienie klienta, tworząc nowy obiekt ApiKeyServiceClientCredentials za pomocą klucza subskrypcji, a następnie wywołaj konstruktor.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Wyślij żądanie wyszukiwania i przetwórz wyniki

Użyj klienta do wysłania żądania wyszukiwania. Użyj elementu „SwiftKey” na potrzeby zapytania wyszukiwania.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Jeśli zostały zwrócone jakiekolwiek wyniki, pobierz pierwszy z nich przy użyciu funkcji videoResults.Value[0]. Następnie wyświetl identyfikator, tytuł i adres URL wideo.

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!");
}

Następne kroki

Tworzenie internetowej aplikacji jednostronicowej

Zobacz też

Użyj tego przewodnika Szybki start, aby rozpocząć wyszukiwanie wiadomości za pomocą biblioteki klienta wyszukiwania wideo Bing dla języka Java. Podczas gdy wyszukiwanie wideo Bing ma interfejs API REST zgodny z większością języków programowania, biblioteka kliencka zapewnia łatwy sposób integracji usługi z aplikacjami. Kod źródłowy dla tego przykładu można znaleźć w witrynie GitHub z dodatkowymi adnotacjami i funkcjami.

Wymagania wstępne

Tworzenie zasobu platformy Azure

Zacznij korzystać z interfejsu API wyszukiwania wideo Bing, tworząc jeden z następujących zasobów platformy Azure:

zasób Wyszukiwanie Bing w wersji 7

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj warstwy cenowej Bezpłatna, aby wypróbować usługę, a następnie uaktualnić ją do warstwy płatnej dla środowiska produkcyjnego.

Zasób z wieloma usługami

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj tego samego klucza i punktu końcowego dla aplikacji w wielu usługach azure AI.

Zainstaluj zależności biblioteki klienta wyszukiwania wideo Bing przy użyciu programu Maven, Gradle lub innego systemu zarządzania zależnościami. Plik POM systemu Maven wymaga następującej deklaracji:

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

Tworzenie i inicjowanie projektu

Utwórz nowy projekt w języku Java w ulubionym środowisku IDE lub edytorze i zaimportuj poniższe biblioteki.

    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;

Tworzenie klienta wyszukiwania

Zaimplementuj klienta VideoSearchAPIImpl, który wymaga punktu końcowego interfejsu API i wystąpienia klasy ServiceClientCredentials.

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

Aby zaimplementować klasę ServiceClientCredentials, wykonaj następujące kroki:

Przesłoń funkcję applyCredentialsFilter(), używając obiektu OkHttpClient.Builder jako parametru.

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

W ramach funkcji applyCredentialsFilter() wywołaj funkcję builder.addNetworkInterceptor(). Utwórz nowy obiekt Interceptor i przesłoń jego metodę intercept() tak, aby przyjmowała obiekt interceptora Chain.
```
//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...
```

W funkcji intercept utwórz zmienne dla żądania. Użyj funkcji Request.Builder(), aby utworzyć żądanie. Dodaj klucz subskrypcji do nagłówka Ocp-Apim-Subscription-Key i zwróć funkcję chain.proceed() w obiekcie żądania.

//...
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);
}
//...

Wysyłanie żądania wyszukiwania i odbieranie odpowiedzi

Utwórz funkcję o nazwie VideoSearch(), która przyjmujące Twój klucz subskrypcji w postaci ciągu. Utwórz wystąpienie utworzonego wcześniej klienta wyszukiwania.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

W ramach funkcji VideoSearch() wyślij żądanie wyszukiwania za pomocą klienta, używając elementu SwiftKey jako terminu wyszukiwania. Jeśli interfejs API wyszukiwania wideo zwrócił wynik, pobierz pierwszy wynik i wyświetl jego identyfikator, nazwę i adres URL wraz z całkowitą liczbę zwróconych filmów wideo.

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!");
    }
}

Wywołaj metodę wyszukiwania z poziomu głównej metody.

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

Następne kroki

Tworzenie internetowej aplikacji jednostronicowej

Zobacz też

Użyj tego przewodnika Szybki start, aby rozpocząć wyszukiwanie wiadomości za pomocą biblioteki klienta wyszukiwania wideo Bing dla języka JavaScript. Podczas gdy wyszukiwanie wideo Bing ma interfejs API REST zgodny z większością języków programowania, biblioteka kliencka zapewnia łatwy sposób integracji usługi z aplikacjami. Kod źródłowy tego przykładu można znaleźć w usłudze GitHub. Zawiera on więcej adnotacji i funkcji.

Wymagania wstępne

Najnowsza wersja środowiska Node.js.
Zestaw SDK wyszukiwania wideo Bing dla języka JavaScript
- Aby go zainstalować, uruchom polecenie npm install @azure/cognitiveservices-videosearch
Klasa CognitiveServicesCredentials z @azure/ms-rest-azure-js pakietu do uwierzytelniania klienta.
- Aby go zainstalować, uruchom polecenie npm install @azure/ms-rest-azure-js

Tworzenie zasobu platformy Azure

Zacznij korzystać z interfejsu API wyszukiwania wideo Bing, tworząc jeden z następujących zasobów platformy Azure:

zasób Wyszukiwanie Bing w wersji 7

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj warstwy cenowej Bezpłatna, aby wypróbować usługę, a następnie uaktualnić ją do warstwy płatnej dla środowiska produkcyjnego.

Zasób z wieloma usługami

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj tego samego klucza i punktu końcowego dla aplikacji w wielu usługach azure AI.

Tworzenie i inicjowanie aplikacji

Utwórz nowy plik JavaScript w ulubionym środowisku IDE lub edytorze i dodaj instrukcję require() dla biblioteki klienta wyszukiwania wideo Bing i CognitiveServicesCredentials moduł. Utwórz zmienną dla klucza subskrypcji.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Utwórz wystąpienie obiektu CognitiveServicesCredentials, korzystając z klucza. Następnie użyj go do utworzenia wystąpienia klienta wyszukiwania wideo.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

Wysyłanie żądania wyszukiwania

Użyj funkcji client.videosOperations.search(), aby wysłać żądanie wyszukiwania do interfejsu API wyszukiwania wideo Bing. Jeśli zostaną zwrócone wyniki wyszukiwania, użyj funkcji .then(), aby je zarejestrować.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Następne kroki

Tworzenie internetowej aplikacji jednostronicowej

Zobacz też

Użyj tego przewodnika Szybki start, aby rozpocząć wyszukiwanie wiadomości za pomocą biblioteki klienta wyszukiwania wideo Bing dla języka Python. Podczas gdy wyszukiwanie wideo Bing ma interfejs API REST zgodny z większością języków programowania, biblioteka kliencka zapewnia łatwy sposób integracji usługi z aplikacjami. Kod źródłowy dla tego przykładu można znaleźć w witrynie GitHub z dodatkowymi adnotacjami i funkcjami.

Tworzenie zasobu platformy Azure

Zacznij korzystać z interfejsu API wyszukiwania wideo Bing, tworząc jeden z następujących zasobów platformy Azure:

zasób Wyszukiwanie Bing w wersji 7

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj warstwy cenowej Bezpłatna, aby wypróbować usługę, a następnie uaktualnić ją do warstwy płatnej dla środowiska produkcyjnego.

Zasób z wieloma usługami

Dostępne za pośrednictwem Azure Portal do momentu usunięcia zasobu.
Użyj tego samego klucza i punktu końcowego dla aplikacji w wielu usługach azure AI.

Wymagania wstępne

Python 2.x lub 3.x
Biblioteka klienta wyszukiwania wideo Bing dla języka Python

Zaleca się używanie środowiska wirtualnego języka Python. Środowisko wirtualne można zainstalować i zainicjować za pomocą modułu venv. Zainstaluj moduł virtualenv dla środowiska Python w wersji 2.7 za pomocą następującego polecenia:

python -m venv mytestenv

Zainstaluj bibliotekę klienta wyszukiwania wideo Bing przy użyciu następujących funkcji:

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

Tworzenie i inicjowanie aplikacji

Utwórz nowy plik w języku Python w ulubionym środowisku IDE lub edytorze i dodaj następujące instrukcje importu.

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

Utwórz zmienną dla klucza subskrypcji.

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

Tworzenie klienta wyszukiwania

Utwórz wystąpienie obiektu CognitiveServicesCredentials i utwórz wystąpienie klienta:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Wysyłanie żądania wyszukiwania i odbieranie odpowiedzi

Użyj funkcji client.videos.search() na potrzeby zapytania wyszukiwania, aby wysłać żądanie do interfejsu API wyszukiwania wideo Bing i uzyskać odpowiedź.
```
video_result = client.videos.search(query="SwiftKey")
```

Jeśli odpowiedź zawiera wyniki wyszukiwania, pobierz pierwszy z nich i wyświetl jego identyfikator, nazwę i adres 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..")

Następne kroki

Tworzenie internetowej aplikacji jednostronicowej

Szybki start: korzystanie z biblioteki klienta wyszukiwania wideo Bing

Wymagania wstępne

Tworzenie zasobu platformy Azure

Tworzenie i inicjowanie projektu

Wyślij żądanie wyszukiwania i przetwórz wyniki

Następne kroki

Zobacz też

Wymagania wstępne

Tworzenie zasobu platformy Azure

Tworzenie i inicjowanie projektu

Tworzenie klienta wyszukiwania

Wysyłanie żądania wyszukiwania i odbieranie odpowiedzi

Następne kroki

Zobacz też

Wymagania wstępne

Tworzenie zasobu platformy Azure

Tworzenie i inicjowanie aplikacji

Wysyłanie żądania wyszukiwania

Następne kroki

Zobacz też

Tworzenie zasobu platformy Azure

Wymagania wstępne

Tworzenie i inicjowanie aplikacji

Tworzenie klienta wyszukiwania

Wysyłanie żądania wyszukiwania i odbieranie odpowiedzi

Następne kroki

Zobacz też

Dodatkowe zasoby