Pular para o conteúdo principal

Casos de Uso

Explore cenários comuns suportados pelo Stream Blueprint:

Plataformas de Vídeo

Fature os clientes com base no consumo de largura de banda de vídeo e qualidade de streaming.

Streaming de Música

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

Eventos Ao Vivo

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

Dados em Tempo Real

Acompanhe 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

Instale o SDK

npm install @dodopayments/ingestion-blueprints
2

Obtenha suas Chaves de API

3

Crie um Medidor

Crie um medidor no seu Painel do Dodo Payments:
  • Nome do Evento: stream_consumption (ou o nome de sua preferência)
  • Tipo de Agregação: sum para acompanhar o total de bytes transmitidos
  • Sobre Propriedade: bytes para faturar com base no uso de largura de banda
4

Acompanhe o Uso do Stream

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
required
Sua chave da API do Dodo Payments do painel.
environment
string
required
Modo de ambiente: test_mode ou live_mode.
eventName
string
required
Nome do evento que corresponde à sua configuração de medidor.

Opções para Acompanhar Bytes de Stream

customerId
string
required
O ID do cliente para atribuição de faturamento.
bytes
number
Número de bytes consumidos no stream. Necessário para faturamento baseado em largura de banda.
metadata
object
Metadados opcionais sobre o stream, como tipo de stream, qualidade, sessionId, etc.

Melhores Práticas

Acompanhe por Chunk: Para streams longos, acompanhe o consumo em partes em vez de esperar que o stream completo termine.
Contagem de Bytes Precisa: Certifique-se de que as contagens de bytes incluam toda a sobrecarga (cabeçalhos, sobrecarga de protocolo) se estiver faturando pela largura de banda total.