التشغيل السريع: استخدام مكتبة العميل Bing للبحث المرئي

مقالة
04/27/2022
قراءة خلال 7 دقائق

تحذير

في 30 أكتوبر 2020، انتقلت واجهات برمجة تطبيقات البحث Bing من الخدمات المعرفية إلى خدمات البحث Bing. يتم توفير هذه الوثائق للرجوع إليها فقط. للحصول على الوثائق المحدثة، راجع وثائق واجهة برمجة تطبيقات البحث Bing. للحصول على إرشادات حول إنشاء موارد Azure جديدة للبحث Bing، راجع إنشاء مورد بحث Bing خلال Azure Marketplace.

استخدم بدء التشغيل السريع لبدء البحث عن الأخبار باستخدام مكتبة العميل الخاصة بـBing Video Search لـ C#. على الرغم من أن خدمة Bing Video Search لديها تطبيق REST API متوافق مع معظم لغات البرمجة، توفر مكتبة العميل وسيلة سهلة لدمج الخدمة في تطبيقاتك. يمكن العثور على التعليمات البرمجية المصدر لهذا النموذج على GitHub بجانب التعليقات التوضيحية الإضافية والميزات.

المتطلبات الأساسية

أي نسخة من Visual Studio 2017 أو أي نسخة أحدث.
إن إطار Json.NET، متوفر NuGet package.

لإضافة مكتبة العميل الخاصة بـ Bing Video Search إلى المشروع، ما عليك سوى تحديد إدارة NuGet Packages من Solution Explorer في Visual Studio. أضف Microsoft.Azure.CognitiveServices.Search.VideoSearch الحزمة.

ثبت [NuGet Video Search SDK package] وثبت أيضاً التبعيات التالية:

Microsoft.Rest.ClientRuntime
Microsoft.Rest.ClientRuntime.Azure
⁧⁩Newtonsoft.Js⁩

أنشئ مورد Azure

بدء استخدام Bing Video Search API عن طريق إنشاء أحد موارد Azure التالية:

مورد Bing Search v7

متوفر من خلال بوابة Azure لطالما لم تحذف المورد.
استخدم مستوى التسعير المجاني لتجربة الخدمة وترقيتها لاحقاً إلي المستوى المدفوع الخاص بعملية الإنتاج.

موارد متعددة الخدمات

متوفر من خلال مدخل Azure إلى أن تقوم بحذف المورد.
استخدم نفس المفتاح ونقطة النهاية للتطبيقات الخاصة بك، عبر الخدمات المعرفية المتعددة.

إنشاء وتهيئة المشروع

أنشئ حل وحدة تحكم C# جديداً في Visual Studio. ثم أضف التالي إلى ملف التعليمات البرمجية الرئيسي.

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

أنشئ مثيل العميل عن طريق إنشاء كائن جديد ApiKeyServiceClientCredentials باستخدام مفتاح الاشتراك، واستدعاء المنشئ.
```
var client = new VideoSearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
```

أرسل طلب بحث ومعالجة النتائج

استخدم العميل لإرسال طلب للبحث. استخدم "SwiftKey" للاستعلام عن البحث.
```
var videoResults = client.Videos.SearchAsync(query: "SwiftKey").Result;
```

إذا تم إرجاع أي نتائج، فعليك الحصول على أول واحد مع videoResults.Value[0]. ثم اطبع معرف الفيديو وعنوانه وعنوان URL.

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

الخطوات التالية

إنشاء تطبيق أحادي الصفحة

راجع أيضًا

استخدم بدء التشغيل السريع لبدء البحث عن الأخبار باستخدام مكتبة العميل الخاصة بـ Bing Video Search لـ Java. على الرغم من أن خدمة Bing Video Search لديها تطبيق REST API متوافق مع معظم لغات البرمجة، توفر مكتبة العميل وسيلة سهلة لدمج الخدمة في تطبيقاتك. يمكن العثور على التعليمات البرمجية المصدر لهذا النموذج على GitHub مع التعليقات التوضيحية الإضافية والميزات.

المتطلبات الأساسية

أنشئ مورد Azure

بدء استخدام Bing Video Search API عن طريق إنشاء أحد موارد Azure التالية:

مورد Bing Search v7

متوفر من خلال بوابة Azure لطالما لم تحذف المورد.
استخدم مستوى التسعير المجاني لتجربة الخدمة وترقيتها لاحقاً إلي المستوى المدفوع الخاص بعملية الإنتاج.

موارد متعددة الخدمات

متوفر من خلال مدخل Azure إلى أن تقوم بحذف المورد.
استخدم نفس المفتاح ونقطة النهاية للتطبيقات الخاصة بك، عبر الخدمات المعرفية المتعددة.

ثبت تبعيات مكتبة العميل الخاصة بـ Bing Video Search باستخدام Maven أو Gradle أو نظام آخر لإدارة التبعية. يتطلب ملف نموذج كائن المشروع الخاص بـ Maven الإعلان التالي:

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

أنشئ مشروعًا وابدأه

أنشئ مشروع Java جديداً في بيئة التطوير المتكاملة أوالمحرر المفضل لك واستورد المكتبات التالية.

    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;

أنشئ عميل بحث

تطبيق العميلVideoSearchAPIImpl الذي يتطلب نقطة نهاية API ومثيل الفئةServiceClientCredentials.

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

لتنفيذ ServiceClientCredentials، ما عليك سوى اتباع الخطوات التالية:

تجاوز الدالة applyCredentialsFilter()، مع كائنOkHttpClient.Builder كمعلمة.

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

داخل applyCredentialsFilter()، استدعِ builder.addNetworkInterceptor(). أنشئ كائن Interceptor جديداً، وتجاوز أسلوبه intercept() لاتخاذ كائن Chain اعتراضي.
```
//...
builder.addNetworkInterceptor(
    new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
        //...    
        }
    });
///...
```

داخل الدالة intercept أنشئ متغيرات لطلبك. استخدم Request.Builder() لإنشاء طلبك. أضف مفتاح الاشتراك إلى رأس الصفحة Ocp-Apim-Subscription-Key، ثم أعدchain.proceed() إلى كائن الطلب.

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

أرسل طلب بحث وتلقَّ الرد

أنشئ دالة تسمى VideoSearch() تأخذ مفتاح الاشتراك كسلسلة. أنشئ مثيل عميل البحث الذي تم إنشاؤه مسبقاً.
```
public static void VideoSearch(String subscriptionKey){
    VideoSearchAPIImpl client = VideoSDK.getClient(subscriptionKey);
    //...
}
```

داخل VideoSearch()، أرسل طلب بحث فيديو باستخدام العميل، مع استخدام SwiftKey كمصطلح البحث. إذا أعادت Video Search API نتيجة، فعليك الحصول على النتيجة الأولى وطباعة معرفها واسمها وعنوان URL الخاص بها، بالإضافة إلى إجمالي عدد مقاطع الفيديو التي تمت إعادتها.

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

استدعِ أسلوب البحث من الأسلوب الرئيسي.

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

الخطوات التالية

إنشاء تطبيق أحادي الصفحة

راجع أيضًا

استخدم هذه البداية السريعة لبدء البحث عن الأخبار باستخدام مكتبة عميل Bing Video Search لـ JavaScript. على الرغم من أن خدمة Bing Video Search لديها تطبيق REST API متوافق مع معظم لغات البرمجة، توفر مكتبة العميل وسيلة سهلة لدمج الخدمة في تطبيقاتك. يمكن العثور على التعليمات البرمجية المصدر لهذه النماذج على GitHub. تحتوي على المزيد من التعليقات التوضيحية والميزات.

المتطلبات الأساسية

أحدث نسخة من Node.js.
Bing Video Search SDK لـ JavaScript
- للتثبيت، ما عليك سوى التشغيل npm install @azure/cognitiveservices-videosearch
فئة CognitiveServicesCredentials من الحزمة @azure/ms-rest-azure-js لمصادقة العميل.
- للتثبيت، قم بتشغيل npm install @azure/ms-rest-azure-js

أنشئ مورد Azure

بدء استخدام Bing Video Search API عن طريق إنشاء أحد موارد Azure التالية:

مورد Bing Search v7

متوفر من خلال بوابة Azure لطالما لم تحذف المورد.
استخدم مستوى التسعير المجاني لتجربة الخدمة وترقيتها لاحقاً إلي المستوى المدفوع الخاص بعملية الإنتاج.

موارد متعددة الخدمات

متوفر من خلال مدخل Azure إلى أن تقوم بحذف المورد.
استخدم نفس المفتاح ونقطة النهاية للتطبيقات الخاصة بك، عبر الخدمات المعرفية المتعددة.

أنشئ وفعل التطبيق

أنشئ ملف JavaScript جديداً في بيئة التطوير المتكاملة أو محرراً مفضلاً لك ثم أضف require() بياناً لمكتبة العميل الخاصة بـ Video Search والوحدة CognitiveServicesCredentials النمطية. أنشئ متغيراً لمفتاح الاشتراك.
```
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const VideoSearchAPIClient = require('@azure/cognitiveservices-videosearch');
```
أنشئ مثيلاً لCognitiveServicesCredentials. ثم استخدمه لإنشاء مثيل لعميل بحث مقاطع الفيديو.
```
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let client = new VideoSearchAPIClient(credentials);
```

أرسل طلب البحث

استخدم client.videosOperations.search() لإرسال طلب بحث إلى Bing Video Search API. عند إرجاع نتائج البحث، استخدم .then() لتسجيل النتيجة.
```
client.videosOperations.search('Interstellar Trailer').then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

الخطوات التالية

إنشاء تطبيق أحادي الصفحة

راجع أيضًا

استخدم بدء التشغيل السريع لبدء البحث عن الأخبار باستخدام مكتبة العميل الخاصة بـ Bing Video Search لـ Python. على الرغم من أن خدمة Bing Video Search لديها تطبيق REST API متوافق مع معظم لغات البرمجة، توفر مكتبة العميل وسيلة سهلة لدمج الخدمة في تطبيقاتك. يمكن العثور على التعليمات البرمجية المصدر لهذا النموذج على GitHub بجانب التعليقات التوضيحية الإضافية والميزات.

أنشئ مورد Azure

بدء استخدام Bing Video Search API عن طريق إنشاء أحد موارد Azure التالية:

مورد Bing Search v7

متوفر من خلال بوابة Azure لطالما لم تحذف المورد.
استخدم مستوى التسعير المجاني لتجربة الخدمة وترقيتها لاحقاً إلي المستوى المدفوع الخاص بعملية الإنتاج.

موارد متعددة الخدمات

متوفر من خلال مدخل Azure إلى أن تقوم بحذف المورد.
استخدم نفس المفتاح ونقطة النهاية للتطبيقات الخاصة بك، عبر الخدمات المعرفية المتعددة.

المتطلبات الأساسية

Python 2.x أو 3.x
مكتبة عميل البحث عن الفيديو Bing لـ python

يوصى باستخدام بيئة Python الظاهرية. يمكنك تثبيت وتفعيل البيئة الظاهرية باستخدام وحدة venv. تثبيت virtualenv لـ Pythone 2.7 مع:

python -m venv mytestenv

تثبيت مكتبة العملاء لـ Bing Video Search مع:

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

إنشاء التطبيق وتكوينه

إنشاء ملف Python جديد في بيئة التطوير المتكاملة المفضلة IDE أو المحرر وإضافة بيانات الاستيراد التالية.

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

إنشاء متغير لمفتاح الاشتراك الخاص بك.

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

إنشاء عميل البحث

إنشاء مثيل من CognitiveServicesCredentials، واستخدامه لإنشاء مثيل العميل:

client = VideoSearchAPI(endpoint, CognitiveServicesCredentials(subscription_key))

إرسال طلب بحث وتلقي استجابة

استخدم client.videos.search() مع استعلام البحث لإرسال طلب إلى Bing Video Search API، والحصول على رد.
```
video_result = client.videos.search(query="SwiftKey")
```

إذا كانت الاستجابة تحتوي على نتائج البحث، فاحصل على أول نتيجة، واطبع معرفها واسمها وعنوان 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..")

الخطوات التالية

إنشاء تطبيق أحادي الصفحة

التشغيل السريع: استخدام مكتبة العميل Bing للبحث المرئي

هل هذه الصفحة مفيدة؟

المتطلبات الأساسية

أنشئ مورد Azure

إنشاء وتهيئة المشروع

أرسل طلب بحث ومعالجة النتائج

الخطوات التالية

راجع أيضًا

المتطلبات الأساسية

أنشئ مورد Azure

أنشئ مشروعًا وابدأه

أنشئ عميل بحث

أرسل طلب بحث وتلقَّ الرد

الخطوات التالية

راجع أيضًا

المتطلبات الأساسية

أنشئ مورد Azure

أنشئ وفعل التطبيق

أرسل طلب البحث

الخطوات التالية

راجع أيضًا

أنشئ مورد Azure

المتطلبات الأساسية

إنشاء التطبيق وتكوينه

إنشاء عميل البحث

إرسال طلب بحث وتلقي استجابة

الخطوات التالية

راجع أيضًا