Skip to main content
Stream Blueprint gửi một usage event đến Dodo Payments cùng số byte mà khách hàng đã sử dụng từ một stream. Meter Sum trên bytes cộng tổng băng thông của từng khách hàng để bạn có thể tính phí. Blueprint này được cung cấp trong npm package @dodopayments/ingestion-blueprints dưới dạng trackStreamBytes().

​
Trường hợp sử dụng

Stream Blueprint phù hợp với các trường hợp sau:

Video Platforms

Tính phí khách hàng dựa trên mức tiêu thụ băng thông video và chất lượng streaming.

Music Streaming

Theo dõi mức sử dụng audio streaming của từng người dùng cho các gói subscription.

Live Events

Giám sát mức tiêu thụ live stream và tính phí cho việc sử dụng băng thông.

Real-Time Data

Theo dõi việc truyền dữ liệu theo thời gian thực cho các ứng dụng IoT và telemetry.
Sử dụng cho các nền tảng video và audio streaming, dịch vụ live streaming và các ứng dụng dữ liệu theo thời gian thực.

​
Bắt đầu nhanh

Để theo dõi mức sử dụng streaming, hãy cài đặt package, tạo một meter và gửi số byte mà mỗi khách hàng đã sử dụng.
1

Install the SDK

Cài đặt package Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Tạo Dodo Payments API key trong Developer → API Keys trên Dodo Payments dashboard, rồi lưu key đó vào environment variable DODO_PAYMENTS_API_KEY. Sử dụng test mode key trong quá trình xây dựng. Test mode key chỉ hoạt động với test_mode.
3

Create a Meter

Trong Dodo Payments dashboard, đi đến Products → Meters và nhấp vào Create Meter. Thiết lập các trường sau:
  • Meter Name: tên mô tả, chẳng hạn như Stream Bandwidth.
  • Event Name: stream_consumption hoặc tên do bạn chọn. Tên này phải khớp chính xác với eventName trong code của bạn (phân biệt chữ hoa chữ thường).
  • Aggregation Type: Sum, để cộng tổng số byte đã streaming.
  • Over Property: bytes, để tính phí dựa trên mức sử dụng băng thông.
  • Measurement Unit: đơn vị hiển thị trên invoice, chẳng hạn như bytes.
4

Track Stream Usage

Gọi trackStreamBytes() với khách hàng và số byte đã sử dụng:

​
Cấu hình

​
Cấu hình Ingestion

Truyền các tùy chọn sau vào new Ingestion():
​
string
bắt buộc
Dodo Payments API key của bạn từ dashboard.
​
string
Environment mode: test_mode hoặc live_mode. Mặc định là test_mode. Tuy nhiên, Dodo Payments SDKs mặc định sử dụng live_mode, vì vậy hãy đặt live_mode một cách rõ ràng trong production.
​
string
bắt buộc
Tên event khớp với Event Name của meter (phân biệt chữ hoa chữ thường).

​
Tùy chọn Track Stream Bytes

Truyền các tùy chọn sau vào trackStreamBytes():
​
string
bắt buộc
Dodo Payments customer ID cần tính phí cho stream, ví dụ cus_123.
​
number
Số byte đã sử dụng trong stream. Bắt buộc khi tính phí dựa trên băng thông. Nếu bỏ qua, event sẽ không có giá trị bytes, nhưng vẫn được tính vào meter Count.
​
object
Metadata tùy chọn về stream, chẳng hạn như loại stream, chất lượng hoặc session ID. Mỗi giá trị phải là string, number hoặc boolean.

​
Thực tiễn tốt nhất

Theo dõi theo Chunk: Với các stream dài, hãy theo dõi mức tiêu thụ theo từng chunk thay vì chờ toàn bộ stream hoàn tất.
Mỗi lần gọi trackStreamBytes() sẽ gửi một event riêng biệt và meter Sum sẽ cộng các chunk lại với nhau.
Đếm Byte Chính xác: Nếu tính phí theo tổng băng thông, hãy bao gồm mọi overhead, chẳng hạn như header và protocol overhead, trong số byte của bạn.
Lần sửa đổi cuối 26 tháng 9, 2026