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

​
ユースケース

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

Video Platforms

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

Music Streaming

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

Live Events

ライブストリームの使用量を監視し、帯域幅使用量に応じて課金します。

Real-Time Data

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

​
クイックスタート

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

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

3

Create a Meter

お使いの Dodo Payments Dashboard でメーターを作成します:
  • Event Name: stream_consumption（または任意の名前）
  • Aggregation Type: sum を使用してストリーミングされた合計バイト数を追跡します
  • Over Property: bytes を使用して帯域幅使用量に基づいて課金します
4

Track Stream Usage

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
必須
ダッシュボードから取得した Dodo Payments API キー。
​
environment
string
必須
環境モード: test_mode または live_mode。
​
eventName
string
必須
メーター設定に一致するイベント名。

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

​
customerId
string
必須
課金の帰属先となる顧客ID。
​
bytes
number
ストリームで消費されたバイト数。帯域幅ベースの課金に必要です。
​
metadata
object
ストリームタイプ、品質、sessionId など、ストリームに関する任意のメタデータ。

​
ベストプラクティス

チャンク単位で追跡: 長時間のストリームでは、全体が完了するのを待たずにチャンク単位で使用量を追跡します。
正確なバイト数の計測: 合計帯域幅に対して請求する場合は、オーバーヘッド（ヘッダー、プロトコルのオーバーヘッドなど）を含めたバイト数になるようにしてください。