Freigeben über


Schnellstart: Verwenden der Clientbibliothek für die Bing-Videosuche

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für C# mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Der Quellcode für dieses Beispiel steht mit zusätzlichen Anmerkungen und Features auf GitHub bereit.

Voraussetzungen

Wählen Sie in Visual Studio im Projektmappen-Explorer die Option NuGet-Pakete verwalten aus, um Ihrem Projekt die Clientbibliothek für die Bing-Videosuche hinzuzufügen. Fügen Sie das Paket Microsoft.Azure.CognitiveServices.Search.VideoSearch hinzu.

Beim Installieren des [NuGet-Pakets mit dem SDK für die Videosuche] werden auch die folgenden Abhängigkeiten installiert:

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

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Erstellen und Initialisieren eines Projekts

  1. Erstellen Sie in Visual Studio eine neue C#-Konsolenprojektmappe. Fügen Sie dann Folgendes in die Hauptcodedatei ein:

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using Microsoft.Azure.CognitiveServices.Search.VideoSearch;
    using Microsoft.Azure.CognitiveServices.Search.VideoSearch.Models;
    
  2. Instanziieren Sie den Client, indem Sie ein neues ApiKeyServiceClientCredentials-Objekt mit Ihrem Abonnementschlüssel erstellen und den Konstruktor aufrufen.

    var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
    

Senden einer Suchanforderung und Verarbeiten der Ergebnisse

  1. Verwenden Sie den Client, um eine Suchanforderung zu senden. Verwenden Sie „SwiftKey“ für die Suchabfrage.

    var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
    
  2. Wenn Ergebnisse zurückgegeben wurden, können Sie das erste Ergebnis mit videoResults.Value[0] abrufen. Geben Sie anschließend die ID, den Titel und die URL des Videos aus.

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

Nächste Schritte

Weitere Informationen

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für Java mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Der Quellcode für dieses Beispiel steht mit zusätzlichen Anmerkungen und Features auf GitHub bereit.

Voraussetzungen

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Installieren Sie die Abhängigkeit für die Bing-Videosuche-Clientbibliothek mithilfe von Maven, Gradle oder einem anderen Abhängigkeitsverwaltungssystem. Die Maven-POM-Datei erfordert die folgende Deklaration:

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

Erstellen und Initialisieren eines Projekts

Erstellen Sie in Ihrer bevorzugten IDE oder in Ihrem bevorzugten Editor ein neues Java-Projekt, und importieren Sie die folgenden Bibliotheken.

    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; 

Erstellen eines Suchclients

  1. Implementieren Sie den VideoSearchAPIImpl-Client, der Ihren API-Endpunkt und eine Instanz der ServiceClientCredentials-Klasse erfordert.

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

    Führen Sie zum Implementieren von ServiceClientCredentials die folgenden Schritte aus:

    1. Überschreiben Sie die Funktion applyCredentialsFilter() mit einem OkHttpClient.Builder-Objekt als Parameter.

      //...
      new ServiceClientCredentials() {
              @Override
              public void applyCredentialsFilter(OkHttpClient.Builder builder) {
              //...
              }
      //...
      
    2. Rufen Sie builder.addNetworkInterceptor() in applyCredentialsFilter() auf. Erstellen Sie ein neues Interceptor-Objekt, und überschreiben Sie seine intercept()-Methode, um ein Interceptor-Objekt vom Typ Chain zu übernehmen.

      //...
      builder.addNetworkInterceptor(
          new Interceptor() {
              @Override
              public Response intercept(Chain chain) throws IOException {
              //...    
              }
          });
      ///...
      
    3. Erstellen Sie in der Funktion intercept Variablen für Ihre Anforderung. Verwenden Sie Request.Builder() zum Erstellen Ihrer Anforderung. Fügen Sie dem Header Ocp-Apim-Subscription-Key Ihren Abonnementschlüssel hinzu, und geben Sie chain.proceed() für das Anforderungsobjekt zurück.

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

Senden einer Suchanforderung und Empfangen der Antwort

  1. Erstellen Sie eine Funktion namens VideoSearch(), die Ihren Abonnementschlüssel als Zeichenfolge akzeptiert. Instanziieren Sie den zuvor erstellten Suchclient.

    public static void VideoSearch(String subscriptionKey){
        VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
        //...
    }
    
  2. Senden Sie innerhalb von VideoSearch() unter Verwendung des Clients eine Videosuchanforderung mit SwiftKey als Suchbegriff. Wenn die API für die Videosuche ein Ergebnis zurückgegeben hat, rufen Sie das erste Ergebnis ab, und geben Sie die ID, den Namen und die URL sowie die Gesamtanzahl der zurückgegebenen Videos aus.

    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. Rufen Sie die Suchmethode über Ihre main-Methode auf.

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

Nächste Schritte

Weitere Informationen

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für JavaScript mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Den Quellcode für dieses Beispiel finden Sie auf GitHub. Er enthält weitere Anmerkungen und Features.

Voraussetzungen

  • Die aktuelle Version von Node.js
  • Das Bing Videosuche-SDK für JavaScript
    • Führen Sie zum Installieren npm install @azure/cognitiveservices-videosearch aus.
  • Die CognitiveServicesCredentials-Klasse aus dem Paket @azure/ms-rest-azure-js zum Authentifizieren des Clients.
    • Führen Sie zum Installieren npm install @azure/ms-rest-azure-js aus.

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Erstellen und Initialisieren der Anwendung

  1. Erstellen Sie eine neue JavaScript-Datei in Ihrer bevorzugten IDE oder einem Editor, und fügen Sie eine require()-Anweisung für die Bing-Videosuche-Clientbibliothek sowie das Modul CognitiveServicesCredentials hinzu. Erstellen Sie eine Variable für Ihren Abonnementschlüssel.

    const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
    const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
    
  2. Erstellen Sie eine Instanz der CognitiveServicesCredentials-Klasse mit Ihrem Schlüssel. Verwenden Sie sie anschließend zum Erstellen einer Instanz des Clients für die Videosuche.

    let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
    let client = new VideoSearchAPIClient(credentials);
    

Senden der Suchanforderung

  1. Senden Sie mithilfe von client.videosOperations.search() eine Suchanforderung an die Bing-Videosuche-API. Wenn die Suchergebnisse zurückgegeben werden, verwenden Sie .then(), um das Ergebnis zu protokollieren.

    client.videosOperations.search('Interstellar Trailer').then((result) => {
        console.log(result.value);
    }).catch((err) => {
        throw err;
    });
    

Nächste Schritte

Weitere Informationen

Verwenden Sie diese Schnellstartanleitung, um unter Verwendung der Bing-Videosuche-Clientbibliothek für Python mit der Suche nach Nachrichten zu beginnen. Die Bing-Videosuche verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, die Clientbibliothek ist jedoch eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Der Quellcode für dieses Beispiel steht mit zusätzlichen Anmerkungen und Features auf GitHub bereit.

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Videosuche-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Voraussetzungen

  • Python 2.x oder 3.x
  • Die Bing-Videosuche-Clientbibliothek für Python

Es wird empfohlen, eine virtuelle Python-Umgebung zu verwenden. Sie können eine virtuelle Umgebung mit dem venv-Modul installieren und initialisieren. Installieren Sie virtualenv für Python 2.7 mit:

python -m venv mytestenv

Installieren Sie die Clientbibliothek für die Bing-Videosuche mit:

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

Erstellen und Initialisieren der Anwendung

  1. Erstellen Sie in Ihrer bevorzugten IDE bzw. in einem Editor eine neue Python-Datei, und fügen Sie die folgenden Importanweisungen hinzu.

    from azure.cognitiveservices.search.videosearch import VideoSearchClient
    from azure.cognitiveservices.search.videosearch.models import VideoPricing, VideoLength, VideoResolution, VideoInsightModule
    from msrest.authentication import CognitiveServicesCredentials
    
  2. Erstellen Sie eine Variable für Ihren Abonnementschlüssel.

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

Erstellen des Suchclients

Erstellen Sie eine Instanz von CognitiveServicesCredentials, und instanziieren Sie den Client:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Senden einer Suchanforderung und Erhalten einer Antwort

  1. Verwenden Sie client.videos.search() mit Ihrer Suchabfrage, um eine Anforderung an die Bing-Videosuche-API zu senden und eine Antwort zu erhalten.

    video_result = client.videos.search(query="SwiftKey")
    
  2. Wenn die Antwort Suchergebnisse enthält, können Sie das erste Ergebnis abrufen und dafür die ID, den Namen und die URL ausgeben.

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

Nächste Schritte

Weitere Informationen