메인 콘텐츠로 건너뛰기

사용 사례

스트림 블루프린트에서 지원하는 일반적인 시나리오를 탐색하세요:

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 등 스트림에 대한 선택적 메타데이터입니다.

모범 사례

Track by Chunk: 긴 스트림의 경우 전체 스트림 완료를 기다리지 않고 청취량을 청크 단위로 추적하세요.
Accurate Byte Counting: 총 대역폭을 기준으로 청구할 경우 모든 오버헤드(헤더, 프로토콜 오버헤드)를 포함하여 바이트 수를 계산하세요.