Udostępnij za pośrednictwem


Szybki start: korzystanie z biblioteki klienta wyszukiwania wideo Bing

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

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

  1. 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;
    
  2. 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

  1. Użyj klienta do wysłania żądania wyszukiwania. Użyj elementu „SwiftKey” na potrzeby zapytania wyszukiwania.

    var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
    
  2. 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

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

  1. 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:

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

      //...
      new ServiceClientCredentials() {
              @Override
              public void applyCredentialsFilter(OkHttpClient.Builder builder) {
              //...
              }
      //...
      
    2. 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 {
              //...    
              }
          });
      ///...
      
    3. 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

  1. 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);
        //...
    }
    
  2. 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!");
        }
    }
    
  3. Wywołaj metodę wyszukiwania z poziomu głównej metody.

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

Następne kroki

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

  1. 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');
    
  2. 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

  1. 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

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

  1. 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
    
  2. 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

  1. 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")
    
  2. 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

Zobacz też