跳转到主要内容

​
用例

探索流媒体蓝图支持的常见场景：

视频平台

根据视频带宽消耗和流媒体质量向客户收费。

音乐流媒体

跟踪每个用户的音频流媒体使用情况以进行订阅分级。

直播活动

监控直播流的消耗并根据带宽使用情况收费。

实时数据

跟踪物联网和遥测应用的实时数据传输。
非常适合视频/音频流媒体平台、直播服务和实时数据应用。

​
快速开始

跟踪客户消耗的流媒体字节：
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等。

​
最佳实践

按块跟踪：对于长流，按块跟踪消耗，而不是等待整个流完成。
准确的字节计数：确保字节计数包括所有开销（头部、协议开销），如果按总带宽计费。