Mulai Cepat: Menggunakan pustaka klien Bing Video Search

Peringatan

Bing Search API berpindah dari Cognitive Services ke Bing Search Services. Mulai 30 Oktober 2020, setiap instans baru Bing Search perlu diprovisikan dengan mengikuti proses yang didokumentasikan di sini. Bing Search API yang diprovisikan menggunakan Cognitive Services akan didukung selama tiga tahun ke depan atau hingga akhir Perjanjian Enterprise Anda, mana saja yang lebih dulu. Untuk mengetahui petunjuk migrasi, lihat Bing Search Services.

Gunakan mulai cepat ini untuk mulai mencari berita dengan pustaka klien Bing Video Search untuk C#. Meskipun Bing Video Search memiliki REST API yang kompatibel dengan sebagian besar bahasa pemrograman, pustaka klien menyediakan cara mudah untuk mengintegrasikan layanan ke dalam aplikasi Anda. Kode sumber untuk sampel ini dapat ditemukan di GitHub dengan anotasi dan fitur tambahan.

Prasyarat

Untuk menambahkan pustaka klien Bing Video Search ke proyek Anda, pilih Kelola Paket NuGet dari Penjelajah Solusi di Visual Studio. Tambahkan Microsoft.Azure.CognitiveServices.Search.VideoSearch paket.

Menginstal paket [NuGet Video Search SDK] juga menginstal dependensi berikut:

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

Membuat grup sumber daya Azure

Mulai gunakan Bing Video Search API dengan membuat salah satu sumber daya Azure berikut:

Sumber daya Bing Search v7

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan tingkat harga gratis untuk mencoba layanan, dan tingkatkan ke tingkat berbayar untuk produksi di kemudian hari.

Sumber daya multilayanan

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa Cognitive Services.

Buat dan inisialisasi proyek

  1. Buat solusi konsol C# baru di Visual Studio. Kemudian tambahkan yang berikut ke dalam file kode utama.

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using Microsoft.Azure.CognitiveServices.Search.VideoSearch;
    using Microsoft.Azure.CognitiveServices.Search.VideoSearch.Models;
    
  2. Beri contoh klien dengan membuat objek baru ApiKeyServiceClientCredentials dengan kunci langganan Anda, dan memanggil konstruktor.

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

Mengirim permintaan pencarian dan memproses hasilnya

  1. Gunakan klien untuk mengirim permintaan pencarian. Gunakan "SwiftKey" untuk kueri pencarian.

    var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
    
  2. Jika ada hasil yang dikembalikan, dapatkan yang pertama dengan videoResults.Value[0]. Kemudian cetak ID, judul, dan url video.

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

Langkah berikutnya

Lihat juga

Gunakan mulai cepat ini untuk mulai mencari berita dengan pustaka klien Bing Video Search untuk Java. Meskipun Bing Video Search memiliki REST API yang kompatibel dengan sebagian besar bahasa pemrograman, library klien menyediakan cara mudah untuk mengintegrasikan layanan ke dalam aplikasi Anda. Kode sumber untuk sampel ini dapat ditemukan di GitHub, dengan anotasi tambahan, dan fitur.

Prasyarat

Membuat grup sumber daya Azure

Mulai gunakan Bing Video Search API dengan membuat salah satu sumber daya Azure berikut:

Sumber daya Bing Search v7

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan tingkat harga gratis untuk mencoba layanan, dan tingkatkan ke tingkat berbayar untuk produksi di kemudian hari.

Sumber daya multilayanan

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa Cognitive Services.

Instal dependensi pustaka klien Bing Video Search dengan menggunakan Maven, Gradle, atau sistem manajemen dependensi lainnya. File POM Maven memerlukan deklarasi berikut:

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

Membuat dan menginisialisasi proyek

Buat proyek Java baru di IDE atau editor favorit Anda, dan impor pustaka berikut.

    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; 

Membuat klien pencarian

  1. Terapkan klien VideoSearchAPIImpl, yang memerlukan titik akhir API Anda, dan instans kelas ServiceClientCredentials.

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

    Untuk mengimplementasikan ServiceClientCredentials, ikuti langkah-langkah berikut:

    1. ganti fungsi applyCredentialsFilter(), dengan objek OkHttpClient.Builder sebagai parameter.

      //...
      new ServiceClientCredentials() {
              @Override
              public void applyCredentialsFilter(OkHttpClient.Builder builder) {
              //...
              }
      //...
      
    2. Dalam applyCredentialsFilter(), panggil builder.addNetworkInterceptor(). Buat objek Interceptor baru, dan ganti metode intercept()-nya untuk mengambil objek pencegat Chain.

      //...
      builder.addNetworkInterceptor(
          new Interceptor() {
              @Override
              public Response intercept(Chain chain) throws IOException {
              //...    
              }
          });
      ///...
      
    3. Dalam fungsi intercept, buat variabel untuk permintaan Anda. Gunakan Request.Builder() untuk membuat permintaan Anda. Tambahkan kunci langganan Anda ke header Ocp-Apim-Subscription-Key, dan kembalikan chain.proceed() di objek permintaan.

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

Mengirim permintaan pencarian dan menerima respons

  1. Buat fungsi yang disebut VideoSearch() yang mengambil kunci langganan Anda sebagai string. But instans klien pencarian yang dibuat sebelumnya.

    public static void VideoSearch(String subscriptionKey){
        VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
        //...
    }
    
  2. Dalam VideoSearch(), Kirim permintaan pencarian video menggunakan klien, dengan SwiftKey sebagai istilah pencarian. Jika Video Search API menampilkan hasil, dapatkan hasil pertama dan cetak id, nama, dan URL-nya, bersama dengan jumlah total video yang ditampilkan.

    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. Panggil metode pencarian dari metode utama Anda.

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

Langkah berikutnya

Lihat juga

Gunakan mulai cepat ini untuk mulai mencari berita dengan pustaka klien Bing Video Search untuk JavaScript. Meskipun Bing Video Search memiliki REST API yang kompatibel dengan sebagian besar bahasa pemrograman, pustaka klien menyediakan cara mudah untuk mengintegrasikan layanan ke dalam aplikasi Anda. Kode sumber untuk sampel ini dapat ditemukan di GitHub. Ini berisi lebih banyak anotasi dan fitur.

Prasyarat

  • Versi terbaru dari Node.js.
  • Bing Video Search SDK untuk JavaScript
    • Untuk menginstal, jalankan npm install @azure/cognitiveservices-videosearch
  • CognitiveServicesCredentials Kelas dari @azure/ms-rest-azure-js paket untuk mengautentikasi klien.
    • Untuk menginstal, jalankan npm install @azure/ms-rest-azure-js

Membuat grup sumber daya Azure

Mulai gunakan Bing Video Search API dengan membuat salah satu sumber daya Azure berikut:

Sumber daya Bing Search v7

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan tingkat harga gratis untuk mencoba layanan, dan tingkatkan ke tingkat berbayar untuk produksi di kemudian hari.

Sumber daya multilayanan

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa Cognitive Services.

Membuat dan menginisialisasi aplikasi

  1. Buat file JavaScript baru di IDE atau editor favorit Anda, dan tambahkan require() pernyataan untuk pustaka klien Bing Video Search, dan CognitiveServicesCredentials modul. Buat variabel untuk kunci langganan Anda.

    const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
    const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
    
  2. Buat contoh dengan CognitiveServicesCredentials kunci Anda. Kemudian gunakan untuk membuat contoh klien pencarian video.

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

Mengirim permintaan pencarian

  1. Gunakan client.videosOperations.search() untuk mengirim permintaan pencarian ke Bing Video Search API. Ketika hasil pencarian dikembalikan, gunakan untuk .then() mencatat hasilnya.

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

Langkah berikutnya

Lihat juga

Gunakan mulai cepat ini untuk mulai mencari berita dengan pustaka klien Bing Video Search untuk Python. Meskipun Bing Video Search memiliki REST API yang kompatibel dengan sebagian besar bahasa pemrograman, pustaka klien menyediakan cara mudah untuk mengintegrasikan layanan ke dalam aplikasi Anda. Kode sumber untuk sampel ini dapat ditemukan di GitHub dengan anotasi dan fitur tambahan.

Membuat grup sumber daya Azure

Mulai gunakan Bing Video Search API dengan membuat salah satu sumber daya Azure berikut:

Sumber daya Bing Search v7

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan tingkat harga gratis untuk mencoba layanan, dan tingkatkan ke tingkat berbayar untuk produksi di kemudian hari.

Sumber daya multilayanan

  • Tersedia melalui portal Azure hingga Anda menghapus sumber daya.
  • Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa Cognitive Services.

Prasyarat

  • Python 2.x atau 3.x
  • Pustaka klien Bing Video Search untuk python

Disarankan agar Anda menggunakan lingkungan virtual python. Anda dapat menginstal dan menginisialisasi lingkungan virtual dengan modul venv. Instal virtualenv untuk Python 2.7 dengan:

python -m venv mytestenv

Instal pustaka klien Bing Video Search dengan:

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

Membuat dan menginisialisasi aplikasi

  1. Buat file Python baru di IDE atau editor favorit Anda, dan tambahkan pernyataan impor berikut.

    from azure.cognitiveservices.search.videosearch import VideoSearchClient
    from azure.cognitiveservices.search.videosearch.models import VideoPricing, VideoLength, VideoResolution, VideoInsightModule
    from msrest.authentication import CognitiveServicesCredentials
    
  2. Buat variabel untuk kunci langganan Anda.

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

Membuat klien pencarian

Buat contoh CognitiveServicesCredentials, dan iberi contoh klien:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

Mengirim permintaan pencarian dan mendapatkan respons

  1. Gunakan client.videos.search() dengan kueri pencarian Anda untuk mengirim permintaan ke Bing Video Search API, dan dapatkan respons.

    video_result = client.videos.search(query="SwiftKey")
    
  2. Jika respons berisi hasil pencarian, dapatkan yang pertama, dan cetak ID, nama, dan urlnya.

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

Langkah berikutnya

Lihat juga