الانتقال إلى المحتوى الرئيسي

حالات الاستخدام

استكشف السيناريوهات الشائعة المدعومة من مخطط البث:

منصات الفيديو

فواتير العملاء بناءً على استهلاك عرض النطاق الترددي للفيديو وجودة البث.

بث الموسيقى

تتبع استخدام بث الصوت لكل مستخدم حسب مستويات الاشتراك.

الفعاليات المباشرة

مراقبة استهلاك البث المباشر وفرض رسوم على استخدام عرض النطاق الترددي.

البيانات في الوقت الحقيقي

تتبع نقل البيانات في الوقت الحقيقي لتطبيقات إنترنت الأشياء والقياسات.
مثالي لمنصات بث الفيديو/الصوت، خدمات البث المباشر، وتطبيقات البيانات في الوقت الحقيقي.

البداية السريعة

تتبع بايتات البث المستهلكة من قبل عملائك:
1

تثبيت SDK

npm install @dodopayments/ingestion-blueprints
2

احصل على مفاتيح API الخاصة بك

3

إنشاء عداد

قم بإنشاء عداد في لوحة معلومات مدفوعات دودي:
  • اسم الحدث: stream_consumption (أو الاسم المفضل لديك)
  • نوع التجميع: sum لتتبع إجمالي البايتات المتدفقة
  • على خاصية: bytes لفوترة بناءً على استخدام عرض النطاق الترددي
4

تتبع استخدام البث

import { Ingestion, trackStreamBytes } from '@dodopayments/ingestion-blueprints';

const ingestion = new Ingestion({
  apiKey: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
  eventName: 'stream_consumption'
});

// Track video stream consumption
await trackStreamBytes(ingestion, {
  customerId: 'customer_123',
  bytes: 10485760, // 10MB
  metadata: {
    stream_type: 'video',
  }
});

التكوين

تكوين الإدخال

apiKey
string
required
مفتاح API لمدفوعات دودي من لوحة المعلومات.
environment
string
required
وضع البيئة: test_mode أو live_mode.
eventName
string
required
اسم الحدث الذي يتطابق مع تكوين العداد الخاص بك.

خيارات تتبع بايتات البث

customerId
string
required
معرف العميل لفوترة النسبة.
bytes
number
عدد البايتات المستهلكة في البث. مطلوب لفوترة بناءً على عرض النطاق الترددي.
metadata
object
بيانات وصفية اختيارية حول البث مثل نوع البث، الجودة، sessionId، إلخ.

أفضل الممارسات

تتبع حسب الشريحة: بالنسبة للبث الطويل، تتبع الاستهلاك في شرائح بدلاً من الانتظار حتى يكتمل البث بالكامل.
عد دقيق للبايتات: تأكد من أن عد البايتات يشمل جميع التكاليف الإضافية (الرؤوس، تكاليف البروتوكول) إذا كنت تقوم بالفوترة بناءً على إجمالي عرض النطاق الترددي.