Quickstart: De Bing Video Search-clientbibliotheek gebruiken

Waarschuwing

Op 30 oktober 2020 zijn de Bing Search-API's verplaatst van Azure AI-services naar Bing Search Services. Deze documentatie wordt alleen ter referentie verstrekt. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Voor instructies over het maken van nieuwe Azure-resources voor Bing Search, zie Een Bing Search-resource maken via Azure Marketplace.

Gebruik deze quickstart om nieuws te zoeken met de Bing Video Search-clientbibliotheek voor C#. Hoewel Bing Video Search een REST API heeft die compatibel is met de meeste programmeertalen, biedt de clientbibliotheek een eenvoudige manier om de service te integreren in uw toepassingen. De broncode voor dit voorbeeld vindt u op GitHub met aanvullende aantekeningen en functies.

Vereiste voorwaarden

Elke versie van Visual Studio 2017 of hoger.
Het Json.NET framework, beschikbaar als een NuGet-pakket.

Als u de Bing Video Search-clientbibliotheek wilt toevoegen aan uw project, selecteert u NuGet-pakketten beheren in Solution Explorer in Visual Studio. Voeg het pakket Microsoft.Azure.CognitiveServices.Search.VideoSearch toe.

Als u het [NuGet Video Search SDK-pakket] installeert, worden ook de volgende afhankelijkheden geïnstalleerd:

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

Een Azure-resource maken

Begin met het gebruik van de Bing Video's zoeken-API door een van de volgende Azure-resources te maken:

Bing Search v7-resource

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik de gratis prijscategorie om de service uit te proberen en voer later een upgrade uit naar een betaalde laag voor productie.

bron voor meerdere diensten

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik dezelfde sleutel en hetzelfde eindpunt voor uw toepassingen, in meerdere Azure AI-services.

Een project maken en initialiseren

Maak een nieuwe C#-consoleoplossing in Visual Studio. Voeg vervolgens het volgende toe aan het hoofdcodebestand.

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

Instantieer de client door een nieuw ApiKeyServiceClientCredentials object te maken met uw abonnementssleutel en de constructor aan te roepen.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

Een zoekaanvraag verzenden en de resultaten verwerken

Gebruik de client om een zoekaanvraag te verzenden. Gebruik SwiftKey voor de zoekquery.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

Als er resultaten zijn geretourneerd, haal de eerste met videoResults.Value[0]. Druk vervolgens de id, titel en URL van de video af.

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

Volgende stappen

Een web-app met één pagina maken

Zie ook

Gebruik deze quickstart om nieuws te zoeken met de Bing Video Search-clientbibliotheek voor Java. Hoewel Bing Video Search een REST API heeft die compatibel is met de meeste programmeertalen, biedt de clientbibliotheek een eenvoudige manier om de service te integreren in uw toepassingen. De broncode voor dit voorbeeld vindt u op GitHub, met aanvullende aantekeningen en functies.

Vereiste voorwaarden

De Java Development Kit (JDK)
De Gson-bibliotheek

Een Azure-resource maken

Begin met het gebruik van de Bing Video's zoeken-API door een van de volgende Azure-resources te maken:

Bing Search v7-resource

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik de gratis prijscategorie om de service uit te proberen en voer later een upgrade uit naar een betaalde laag voor productie.

bron voor meerdere diensten

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik dezelfde sleutel en hetzelfde eindpunt voor uw toepassingen, in meerdere Azure AI-services.

Installeer de afhankelijkheden van de Bing Video Search-clientbibliotheek met behulp van Maven, Gradle of een ander systeem voor afhankelijkheidsbeheer. Voor het Maven POM-bestand is de volgende declaratie vereist:

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

Een project maken en initialiseren

Maak een nieuw Java-project in uw favoriete IDE of editor en importeer de volgende 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;

Een zoekclient maken

Implementeer de VideoSearchAPIImpl-client, waarvoor uw API-eindpunt is vereist en een exemplaar van de ServiceClientCredentials-klasse.

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

Voer de volgende stappen uit om te implementeren ServiceClientCredentials:

overschrijf de functie applyCredentialsFilter(), met een OkHttpClient.Builder-object als parameter.

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

Binnen applyCredentialsFilter(), bel builder.addNetworkInterceptor(). Maak een nieuw Interceptor-object en overschrijf de intercept()-methode zodat het een Chain-interceptorobject kan aannemen.

//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...

Maak in de intercept functie variabelen voor uw aanvraag. Gebruik Request.Builder() om uw aanvraag te maken. Voeg uw abonnementssleutel toe aan de Ocp-Apim-Subscription-Key-header en retourneer chain.proceed() op het aanvraagobject.

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

Een zoekaanvraag verzenden en het antwoord ontvangen

Maak een functie VideoSearch() die uw abonnementssleutel als tekenreeks gebruikt. Instantieer de zoekclient die u eerder hebt gemaakt.

public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}

Binnen VideoSearch() verzend je een videozoekopdracht met behulp van de client, met SwiftKey als zoekterm. Als de Video's zoeken-API een resultaat heeft geretourneerd, haalt u het eerste resultaat op en drukt u de id, naam en URL af, samen met het totale aantal geretourneerde video's.

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

Roep de zoekmethode aan vanuit uw hoofdmethode.

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

Volgende stappen

Een web-app met één pagina maken

Zie ook

Gebruik deze starthandleiding om te beginnen met zoeken naar nieuws met de Bing Video Search clientbibliotheek voor JavaScript. Hoewel Bing Video Search een REST API heeft die compatibel is met de meeste programmeertalen, biedt de clientbibliotheek een eenvoudige manier om de service te integreren in uw toepassingen. De broncode voor dit voorbeeld is te vinden op GitHub. Het bevat meer aantekeningen en functies.

Vereiste voorwaarden

De nieuwste versie van Node.js.
De Bing Video Search SDK voor JavaScript
- Voer npm install @azure/cognitiveservices-videosearch uit om deze te installeren
De CognitiveServicesCredentials-klasse van @azure/ms-rest-azure-js pakket om de client te verifiëren.
- Voer npm install @azure/ms-rest-azure-js uit om deze te installeren

Een Azure-resource maken

Begin met het gebruik van de Bing Video's zoeken-API door een van de volgende Azure-resources te maken:

Bing Search v7-resource

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik de gratis prijscategorie om de service uit te proberen en voer later een upgrade uit naar een betaalde laag voor productie.

bron voor meerdere diensten

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik dezelfde sleutel en hetzelfde eindpunt voor uw toepassingen, in meerdere Azure AI-services.

De toepassing maken en initialiseren

Maak een nieuw JavaScript-bestand in uw favoriete IDE of editor en voeg een require() instructie toe voor de Bing Video Search-clientbibliotheek en CognitiveServicesCredentials -module. Maak een variabele voor uw abonnementssleutel.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
Maak een exemplaar van CognitiveServicesCredentials met uw sleutel. Gebruik deze vervolgens om een exemplaar van de videozoekclient te maken.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

De zoekaanvraag verzenden

Gebruik client.videosOperations.search() om een zoekaanvraag naar de Bing Video Search API te verzenden. Wanneer de zoekresultaten worden geretourneerd, gebruik .then() om het resultaat te registreren.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Volgende stappen

Een web-app met één pagina maken

Zie ook

Gebruik deze quickstart om nieuws te zoeken met de Bing Video Search-clientbibliotheek voor Python. Hoewel Bing Video Search een REST API heeft die compatibel is met de meeste programmeertalen, biedt de clientbibliotheek een eenvoudige manier om de service te integreren in uw toepassingen. De broncode voor dit voorbeeld vindt u op GitHub met aanvullende aantekeningen en functies.

Een Azure-resource maken

Begin met het gebruik van de Bing Video's zoeken-API door een van de volgende Azure-resources te maken:

Bing Search v7-resource

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik de gratis prijscategorie om de service uit te proberen en voer later een upgrade uit naar een betaalde laag voor productie.

bron voor meerdere diensten

Beschikbaar via de Azure-portal totdat u de resource verwijdert.
Gebruik dezelfde sleutel en hetzelfde eindpunt voor uw toepassingen, in meerdere Azure AI-services.

Vereiste voorwaarden

Python 2.x or 3.x
De Bing Video Search-clientbibliotheek voor Python

Het wordt aanbevolen om een virtuele Python-omgeving te gebruiken. U kunt een virtuele omgeving installeren en initialiseren met de venv-module. Installeer virtualenv voor Python 2.7 met:

python -m venv mytestenv

Installeer de Bing Video Search-clientbibliotheek met:

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

De toepassing maken en initialiseren

Maak een nieuw Python-bestand in uw favoriete IDE of editor en voeg de volgende importinstructies toe.

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

Maak een variabele voor uw abonnementssleutel.

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

De zoekclient maken

Maak een instantie van de CognitiveServicesCredentials en instantiateer de client:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Een zoekaanvraag verzenden en een antwoord krijgen

Gebruik client.videos.search() met je zoekopdracht om een verzoek naar de Bing Video Search API te verzenden en een antwoord te krijgen.
```
video_result = client.videos.search(query="SwiftKey")
```

Als het antwoord zoekresultaten bevat, haalt u de eerste op en drukt u de ID, naam en URL af.

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

Volgende stappen

Een web-app met één pagina maken

Zie ook

Last updated on 2020-10-22

Delen via

Quickstart: De Bing Video Search-clientbibliotheek gebruiken

Vereiste voorwaarden

Een Azure-resource maken

Een project maken en initialiseren

Een zoekaanvraag verzenden en de resultaten verwerken

Volgende stappen

Zie ook

Vereiste voorwaarden

Een Azure-resource maken

Een project maken en initialiseren

Een zoekclient maken

Een zoekaanvraag verzenden en het antwoord ontvangen

Volgende stappen

Zie ook

Vereiste voorwaarden

Een Azure-resource maken

De toepassing maken en initialiseren

De zoekaanvraag verzenden

Volgende stappen

Zie ook

Een Azure-resource maken

Vereiste voorwaarden

De toepassing maken en initialiseren

De zoekclient maken

Een zoekaanvraag verzenden en een antwoord krijgen

Volgende stappen

Zie ook

Aanvullende resources