72 lines
2.8 KiB
Go
72 lines
2.8 KiB
Go
package transcode
|
|
|
|
import "time"
|
|
|
|
// 三层上限 + 并发 + 超时的默认取值（design/25 §2.5，取值照设计，不得自行改）。
|
|
// 全部具名：本包不存在裸数字。
|
|
const (
|
|
// DefaultMaxInputBytes 是单次转码的输入字节上限（5 MiB）。取值与
|
|
// mediafetch.MaxVoiceBytes 相同但**不共用常量**：一个是「入站内联上限」，
|
|
// 一个是「转码输入上限」，共用会让「改一个静默改另一个」（design/25 §2.5）。
|
|
DefaultMaxInputBytes = 5 << 20
|
|
// DefaultMaxOutputBytes 是解码产物的字节上限（64 MiB）。AMR-NB 是唯一会放大的
|
|
// 那条路：12.2 kbps ≈ 1525 B/s → 8 kHz 单声道 PCM16 = 16000 B/s ≈ 10.5×，
|
|
// 加帧头最坏约 12.8×，5 MiB 输入最坏 ⇒ ≈64 MiB。没有这条闸就是
|
|
// 「上传 5 MB、内存里长到 64 MB」。
|
|
DefaultMaxOutputBytes = 64 << 20
|
|
// DefaultMaxDuration 是可确证的时长上限（10 分钟）：「正常语音」与「把整段录音
|
|
// 伪装成语音」的分界。可从 AMR 帧数确证（一帧 20ms），绝不估算。
|
|
DefaultMaxDuration = 10 * time.Minute
|
|
// DefaultConcurrency 是全局并发槽数（信号量容量）。
|
|
DefaultConcurrency = 2
|
|
// DefaultTimeout 是单次调用的 ctx 超时上限。
|
|
DefaultTimeout = 10 * time.Second
|
|
)
|
|
|
|
// Limits 是一次转码的资源约束（design/25 §2.5）。零值字段由 Engine 用上面的
|
|
// 具名默认补足，因此 `Limits{}` 是安全的「全默认」。
|
|
type Limits struct {
|
|
// MaxInputBytes 输入字节上限；命中即 ErrInputTooLarge（解码前拒绝）。
|
|
MaxInputBytes int
|
|
// MaxOutputBytes 产物字节上限；命中即 ErrOutputTooLarge。
|
|
MaxOutputBytes int
|
|
// MaxDuration 可确证的时长上限；命中即 ErrInputTooLarge。
|
|
MaxDuration time.Duration
|
|
// Concurrency 全局并发槽数；槽满即 ErrBusy（快速失败，不排队）。
|
|
Concurrency int
|
|
// Timeout 单次调用的超时；命中即 ErrTimeout。
|
|
Timeout time.Duration
|
|
}
|
|
|
|
// DefaultLimits 返回一组全默认的限额（design/25 §2.5 的取值）。
|
|
func DefaultLimits() Limits {
|
|
return Limits{
|
|
MaxInputBytes: DefaultMaxInputBytes,
|
|
MaxOutputBytes: DefaultMaxOutputBytes,
|
|
MaxDuration: DefaultMaxDuration,
|
|
Concurrency: DefaultConcurrency,
|
|
Timeout: DefaultTimeout,
|
|
}
|
|
}
|
|
|
|
// withDefaults 用默认值补足零值字段。负数与零一并按「未配置」处理：限额的
|
|
// 零值若照字面生效会变成「一字节都不许」，那不是任何调用方想要的行为。
|
|
func (l Limits) withDefaults() Limits {
|
|
if l.MaxInputBytes <= 0 {
|
|
l.MaxInputBytes = DefaultMaxInputBytes
|
|
}
|
|
if l.MaxOutputBytes <= 0 {
|
|
l.MaxOutputBytes = DefaultMaxOutputBytes
|
|
}
|
|
if l.MaxDuration <= 0 {
|
|
l.MaxDuration = DefaultMaxDuration
|
|
}
|
|
if l.Concurrency <= 0 {
|
|
l.Concurrency = DefaultConcurrency
|
|
}
|
|
if l.Timeout <= 0 {
|
|
l.Timeout = DefaultTimeout
|
|
}
|
|
return l
|
|
}
|