عروض الشرائح

تتيح لك واجهة API الفيديو نشر مقاطع فيديو عرض الشرائح على الصفحات والمجموعات. علمًا بأن النشر لدى المستخدمين غير مدعوم. وتستخدم الأمثلة الواردة في هذا المستند عقدة الصفحة، ولكنها تنطبق أيضًا على عُقد المجموعة.

إنشاء عرض شرائح

أرسل طلب POST إلى عنصر الربط مقاطع فيديو الصفحة، واحرص على تضمين كائن يحتوي على مصفوفة من عناوين URL للصورة لاستخدامها في إنشاء الفيديو. ويجب استضافة الصور على خادم قابل للوصول العام. كما يجب أن يوضح الكائن مدة عرض كل صورة ومدة الانتقال بين الصور.

تنسيقات الصور

JPG، JPEG، PNG، BMP، ICO

أبعاد الصور

إذا كانت الصور بأبعاد مختلفة، فستعمل واجهة API على اقتصاصها، وضبط حجمها إلى 600x600 بيكسل، وإنشاء فيديو مربع. وإذا كانت جميع الصور بالبُعد نفسه، فسيتطابق الفيديو مع هذا البُعد.

المتطلبات

  • يجب أن يتضمن الطلب 3 صور كحد أدنى، و7 صور كحد أقصى.
  • يجب أن تكون كل صورة بحجم 10 ميجابايت أو أقل.

بناء جملة الطلب

POST /v19.0/{page-id}/videos ?access_token={access-token} &slideshow_spec={slideshow-spec}

المعلمات المطلوبة

المعلمة الوصف

access_token

يمثل رمز وصول الصفحة في حالة النشر على صفحة، أو رمز وصول المستخدم في حالة النشر على مجموعة.

slideshow_spec

يمثل كائن يحتوي على مصفوفة من عناوين URL للصور والخصائص التي توضح الفيديو. ويمكنك الرجوع إلى خصائص كائن عرض الشرائح أدناه.

خصائص كائن عرض الشرائح

الخاصية الوصف

images_urls
المطلوبة

تمثل مصفوفة تحتوي على 3-7 عناوين URL للصور لاستخدامها عند إنشاء الفيديو.

duration_ms

يمثل عددًا صحيحًا يشير إلى المدة بالمللي ثانية والتي يجب خلالها عرض كل صورة في الفيديو. علمًا بأن القيمة الافتراضية هي 1750. ويجب أن تكون القيمة أكبر من 0.

transition_ms

يمثل عددًا صحيحًا يشير إلى مدة الانتقال بالتضاؤل المتداخل بين الصور بالمللي ثانية. علمًا بأن القيمة الافتراضية هي 250. ويجب أن تكون القيمة أكبر من 0.

عينة من الطلب

curl -X POST \ "https://graph-video.facebook.com/v19.0/1755847768034402/videos" \ -F "access_token=EAADd..." \ -F "slideshow_spec={ \ "images_urls":[ \ 'https://socialsizz...1.png', \ 'https://socialsizz...2.png', \ 'https://socialsizz...3.png' \ ], \ "duration_ms": 5000, \ "transition_ms": 200 \ }"

عند نجاح الأمر، ستستجيب واجهة API من خلال معرف الفيديو الذي تم إنشاؤه حديثًا.

عينة من الاستجابة بلغة JSON

{ "id":"277487313407856" }