Pular para o conteúdo principal

​
Casos de Uso

Explore cenários comuns suportados pelo Stream Blueprint:

Video Platforms

Fature os clientes com base no consumo de largura de banda de vídeo e na qualidade da transmissão.

Music Streaming

Acompanhe o uso de streaming de áudio por usuário para níveis de assinatura.

Live Events

Monitore o consumo de transmissões ao vivo e cobre pelo uso de largura de banda.

Real-Time Data

Monitore a transferência de dados em tempo real para aplicações de IoT e telemetria.
Perfeito para plataformas de streaming de vídeo/áudio, serviços de streaming ao vivo e aplicações de dados em tempo real.

​
Início Rápido

Acompanhe os bytes de streaming consumidos pelos seus clientes:
1

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

3

Create a Meter

Crie um medidor no seu Dodo Payments Dashboard:
  • Nome do Evento: stream_consumption (ou o nome de sua preferência)
  • Tipo de Agregação: sum para rastrear os bytes totais transmitidos
  • Over Property: bytes para cobrar com base no uso de largura de banda
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',
  }
});

​
Configuração

​
Configuração de Ingestão

​
apiKey
string
obrigatório
Sua chave da API Dodo Payments do painel.
​
environment
string
obrigatório
Modo de ambiente: test_mode ou live_mode.
​
eventName
string
obrigatório
Nome do evento que corresponde à configuração do seu medidor.

​
Opções para Acompanhar Bytes de Stream

​
customerId
string
obrigatório
O ID do cliente para atribuição de cobrança.
​
bytes
number
Número de bytes consumidos na transmissão. Obrigatório para cobrança baseada em largura de banda.
​
metadata
object
Metadados opcionais sobre a transmissão, como tipo de stream, qualidade, sessionId, etc.

​
Melhores Práticas

Rastreie por Blocos: Para transmissões longas, acompanhe o consumo em blocos em vez de esperar que toda a transmissão seja concluída.
Contagem precisa de bytes: garanta que a contagem de bytes inclua toda a sobrecarga (cabeçalhos, sobrecarga de protocolo) ao cobrar pela largura de banda total.