メインコンテンツへスキップ

​
ユースケース

ストリームブループリントがサポートする一般的なシナリオを探ります：

ビデオプラットフォーム

ビデオの帯域幅消費とストリーミング品質に基づいて顧客に請求します。

音楽ストリーミング

サブスクリプション層ごとにユーザーのオーディオストリーミング使用量を追跡します。

ライブイベント

ライブストリームの消費を監視し、帯域幅使用量に対して請求します。

リアルタイムデータ

IoTおよびテレメトリーアプリケーションのためのリアルタイムデータ転送を追跡します。
ビデオ/オーディオストリーミングプラットフォーム、ライブストリーミングサービス、リアルタイムデータアプリケーションに最適です。

​
クイックスタート

顧客によって消費されたストリーミングバイトを追跡します：
1

SDKをインストール

npm install @dodopayments/ingestion-blueprints
2

APIキーを取得

3

メーターを作成

Dodo Payments Dashboardでメーターを作成します：
  • イベント名: 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
ダッシュボードからのDodo Payments APIキー。
​
environment
string
required
環境モード：test_mode または live_mode。
​
eventName
string
required
メーター設定に一致するイベント名。

​
ストリームバイト追跡オプション

​
customerId
string
required
請求の帰属のための顧客ID。
​
bytes
number
ストリームで消費されたバイト数。帯域幅ベースの請求に必要です。
​
metadata
object
ストリームの種類、品質、sessionIdなどのオプションのメタデータ。

​
ベストプラクティス

チャンクごとに追跡: 長いストリームの場合、全体のストリームが完了するのを待つのではなく、チャンクごとに消費を追跡します。
正確なバイトカウント: 帯域幅の合計を請求する場合、バイトカウントにすべてのオーバーヘッド（ヘッダー、プロトコルオーバーヘッド）が含まれていることを確認してください。