Mulai Cepat: Menggunakan pustaka klien Bing Video Search

Artikel
07/27/2022
7 menit untuk membaca

Peringatan

Pada 30 Oktober 2020, Bing Search API berpindah dari Cognitive Services ke Bing Search Services. Dokumentasi ini disediakan hanya untuk referensi. Untuk dokumentasi terbaru, lihat dokumentasi Bing Search API. Untuk petunjuk tentang cara membuat sumber daya Azure baru untuk pencarian Bing, lihat Membuat sumber daya Bing Search melalui Marketplace Azure.

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

Edisi Visual Studio 2017 atau yang lebih baru.
Kerangka Json.NET, tersedia sebagai paket NuGet.

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 Microsoft 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 Microsoft Azure hingga Anda menghapus sumber daya.
Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa Cognitive Services.

Membuat dan menginisialisasi proyek

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;

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

Gunakan klien untuk mengirim permintaan pencarian. Gunakan "SwiftKey" untuk kueri pencarian.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

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

Membuat aplikasi web satu halaman

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 Microsoft 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 Microsoft 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

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:

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

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

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

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

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

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

Panggil metode pencarian dari metode utama Anda.

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

Langkah berikutnya

Membuat aplikasi web satu halaman

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
Kelas CognitiveServicesCredentials dari paket @azure/ms-rest-azure-js 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 Microsoft 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 Microsoft Azure hingga Anda menghapus sumber daya.
Gunakan kunci dan titik akhir yang sama untuk aplikasi Anda, di beberapa Cognitive Services.

Membuat dan menginisialisasi aplikasi

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');
```

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

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

Membuat aplikasi web satu halaman

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 Microsoft 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 Microsoft 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

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

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

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

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

Membuat aplikasi web satu halaman