Partilhar via


Início Rápido: Utilizar a biblioteca de cliente da Pesquisa de Vídeos do Bing

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para C#. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub com anotações e funcionalidades adicionais.

Pré-requisitos

Para adicionar a biblioteca de cliente da Pesquisa de Vídeos do Bing ao seu projeto, selecione Gerir Pacotes NuGet de Explorador de Soluções no Visual Studio. Adicione o pacote Microsoft.Azure.CognitiveServices.Search.VideoSearch.

A instalação do [pacote do SDK de Pesquisa de Vídeos NuGet] também instala as seguintes dependências:

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

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Criar e inicializar um projeto

  1. Crie uma nova solução de consola C# no Visual Studio. Em seguida, adicione o seguinte ao ficheiro de código principal.

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using Microsoft.Azure.CognitiveServices.Search.VideoSearch;
    using Microsoft.Azure.CognitiveServices.Search.VideoSearch.Models;
    
  2. Instanciar o cliente ao criar um novo ApiKeyServiceClientCredentials objeto com a sua chave de subscrição e chamar o construtor.

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

Enviar um pedido de pesquisa e processar os resultados

  1. Utilize o cliente para enviar um pedido de pesquisa. Utilize "SwiftKey" para a consulta de pesquisa.

    var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
    
  2. Se forem devolvidos resultados, obtenha o primeiro com videoResults.Value[0]. Em seguida, imprima o ID, o título e o URL do vídeo.

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

Passos seguintes

Ver também

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para Java. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub, com anotações e funcionalidades adicionais.

Pré-requisitos

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Instale as dependências da biblioteca de cliente do Bing Video Search com o Maven, o Gradle ou outro sistema de gestão de dependências. O ficheiro POM do Maven necessita da seguinte declaração:

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

Criar e inicializar um projeto

Crie um novo projeto Java no seu IDE ou editor favorito e importe as seguintes bibliotecas.

    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; 

Criar um cliente de pesquisa

  1. Implemente o VideoSearchAPIImpl cliente, que requer o ponto final da API e uma instância da ServiceClientCredentials classe.

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

    Para implementar ServiceClientCredentialso , siga estes passos:

    1. substitua a applyCredentialsFilter() função, com um OkHttpClient.Builder objeto como parâmetro.

      //...
      new ServiceClientCredentials() {
              @Override
              public void applyCredentialsFilter(OkHttpClient.Builder builder) {
              //...
              }
      //...
      
    2. No applyCredentialsFilter(), chame builder.addNetworkInterceptor(). Crie um novo Interceptor objeto e substitua o respetivo intercept() método para utilizar um Chain objeto de intercetor.

      //...
      builder.addNetworkInterceptor(
          new Interceptor() {
              @Override
              public Response intercept(Chain chain) throws IOException {
              //...    
              }
          });
      ///...
      
    3. Na função intercept , crie variáveis para o seu pedido. Utilize Request.Builder() para criar o seu pedido. Adicione a chave de subscrição ao Ocp-Apim-Subscription-Key cabeçalho e regresse chain.proceed() ao objeto de pedido.

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

Enviar um pedido de pesquisa e receber a resposta

  1. Crie uma função denominada VideoSearch() que utiliza a chave de subscrição como uma cadeia. Instanciar o cliente de pesquisa criado anteriormente.

    public static void VideoSearch(String subscriptionKey){
        VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
        //...
    }
    
  2. No VideoSearch(), envie um pedido de pesquisa de vídeo com o cliente, com SwiftKey como o termo de pesquisa. Se a API de Pesquisa de Vídeo devolveu um resultado, obtenha o primeiro resultado e imprima o respetivo ID, nome e URL, juntamente com o número total de vídeos devolvidos.

    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. Chame o método de pesquisa a partir do seu método principal.

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

Passos seguintes

Ver também

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para JavaScript. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub. Contém mais anotações e funcionalidades.

Pré-requisitos

  • A versão mais recente do Node.js.
  • O SDK de Pesquisa de Vídeos do Bing para JavaScript
    • Para instalar, execute npm install @azure/cognitiveservices-videosearch
  • A CognitiveServicesCredentials classe do @azure/ms-rest-azure-js pacote para autenticar o cliente.
    • Para instalar, execute npm install @azure/ms-rest-azure-js

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Criar e inicializar a aplicação

  1. Crie um novo ficheiro JavaScript no seu IDE ou editor favorito e adicione uma require() instrução para a biblioteca e CognitiveServicesCredentials módulo de cliente da Pesquisa de Vídeos do Bing. Crie uma variável para a sua chave de subscrição.

    const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
    const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
    
  2. Crie uma instância de CognitiveServicesCredentials com a sua chave. Em seguida, utilize-a para criar uma instância do cliente de pesquisa de vídeo.

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

Enviar o pedido de pesquisa

  1. Utilize client.videosOperations.search() para enviar um pedido de pesquisa para a API de Pesquisa de Vídeos do Bing. Quando os resultados da pesquisa forem devolvidos, utilize .then() para registar o resultado.

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

Passos seguintes

Ver também

Utilize este início rápido para começar a procurar notícias com a biblioteca de cliente da Pesquisa de Vídeos do Bing para Python. Embora a Pesquisa de Vídeos do Bing tenha uma API REST compatível com a maioria das linguagens de programação, a biblioteca de cliente fornece uma forma fácil de integrar o serviço nas suas aplicações. O código fonte para este exemplo pode ser encontrado no GitHub com anotações e funcionalidades adicionais.

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa de Vídeos do Bing ao criar um dos seguintes recursos do Azure:

Pesquisa do Bing recurso v7

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

  • Disponível através do portal do Azure até eliminar o recurso.
  • Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Pré-requisitos

  • Python 2.x ou 3.x
  • A biblioteca de cliente da Pesquisa de Vídeos do Bing para python

Recomenda-se que utilize um ambiente virtual python. Pode instalar e inicializar um ambiente virtual com o módulo venv. Instale o virtualenv para Python 2.7 com:

python -m venv mytestenv

Instale a biblioteca de cliente da Pesquisa de Vídeos do Bing com:

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

Criar e inicializar a aplicação

  1. Crie um novo ficheiro Python no seu IDE ou editor favorito e adicione as seguintes instruções de importação.

    from azure.cognitiveservices.search.videosearch import VideoSearchClient
    from azure.cognitiveservices.search.videosearch.models import VideoPricing, VideoLength, VideoResolution, VideoInsightModule
    from msrest.authentication import CognitiveServicesCredentials
    
  2. Crie uma variável para a sua chave de subscrição.

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

Criar o cliente de pesquisa

Crie uma instância do CognitiveServicesCredentialse instancie o cliente:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Enviar um pedido de pesquisa e obter uma resposta

  1. Utilize client.videos.search() com a consulta de pesquisa para enviar um pedido para a API de Pesquisa de Vídeos do Bing e obter uma resposta.

    video_result = client.videos.search(query="SwiftKey")
    
  2. Se a resposta contiver resultados de pesquisa, obtenha o primeiro e imprima o respetivo ID, nome e 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..")
    

Passos seguintes

Ver também