feat(channelbridge): 出站语音结论落 voice 列并挂出站 Media(M58)
- voice.Ref 增 SourceTTS 与 FallbackReason,Validate/IsZero/validSource 同步 - 出站成功:INSERT -> 补写 voice 列 -> notify(首帧即带 voice) - 出站降级:source=tts + status=failed + fallbackReason,正文原样 - 首条气泡挂出站 Media(新开条目,不复制 target.Media) - gateway historyVoice 投影 fallbackReason - 新增 outbound_voice.go 与整链 e2e 测试(含变异打红验证时序)
This commit is contained in:
1 parent
9f6243a729
commit
28afa11aeb
13 files changed
+755
-44
No files matched your search
@@ -32,6 +32,9 @@ const (
|
||||
// SourcePlatform 表示渠道平台自带转写(例如微信 iLink 的 `voice_item.text`):
|
||||
// 平台把语音转成文字后送达,我们**不调 ASR**(不重复付费)。
|
||||
SourcePlatform Source = "platform"
|
||||
// SourceTTS 表示正文是我们自己合成的语音(出站方向,design/25 §7.1):成功时
|
||||
// Name 指向那份可播副本,降级时 Status=failed 且正文照发文本、只带降级原因。
|
||||
SourceTTS Source = "tts"
|
||||
)
|
||||
|
||||
// Status 是转写结果的**三态闭集**(design/24 §10.4)。客户端按它分支,**绝不按正文
|
||||
@@ -39,7 +42,8 @@ const (
|
||||
type Status string
|
||||
|
||||
const (
|
||||
// StatusTranscribed 表示正文即转写文本(真转写,或平台自带转写)。
|
||||
// StatusTranscribed 表示正文即转写文本(真转写,或平台自带转写);出站方向表示
|
||||
// **合成成功**(正文即这段语音的文字内容,Name 指向可播副本)。
|
||||
StatusTranscribed Status = "transcribed"
|
||||
// StatusEmpty 表示转写成功但没识别出文字(静音 / 太短 / 全是噪声)——是服务正常
|
||||
// 的空结果,**不是**故障。
|
||||
@@ -85,6 +89,10 @@ type Ref struct {
|
||||
// DurationMs 是时长,**只有渠道如实给出或转码产物可确证时**才 >0;读不出来就是 0
|
||||
// (编码时该键缺席)。**绝不估算**(design/24 §10.4)。
|
||||
DurationMs int64 `json:"durationMs,omitempty"`
|
||||
// FallbackReason 只在**出站合成降级**时非空(Source=tts、Status=failed):说明为什么
|
||||
// 这条消息没能变成语音(能力未接线 / 预算超时 / 合成为空)。入站转写不使用它 ——
|
||||
// 入站的失败原因由正文那行诚实提示承载。
|
||||
FallbackReason string `json:"fallbackReason,omitempty"`
|
||||
}
|
||||
|
||||
// IsVoice 报告这条事实是否代表「这条消息来自一条语音消息」(= 来源与状态都在闭集内)。
|
||||
@@ -110,6 +118,11 @@ func (r Ref) Validate() error {
|
||||
if r.DurationMs < 0 {
|
||||
return fmt.Errorf("%w: negative durationMs %d", ErrBadRef, r.DurationMs)
|
||||
}
|
||||
// 降级原因只属于失败态:成功还带原因会让人以为「其实降级了」,客户端也就无从按
|
||||
// status 单点分支(design/24 §10.4 的「客户端绝不按文案分支」同一条纪律)。
|
||||
if r.FallbackReason != "" && r.Status != StatusFailed {
|
||||
return fmt.Errorf("%w: fallbackReason with status %q", ErrBadRef, r.Status)
|
||||
}
|
||||
switch {
|
||||
case r.Name == "" && (r.MIME != "" || r.Size != 0):
|
||||
return fmt.Errorf("%w: mime/size without name", ErrBadRef)
|
||||
@@ -124,7 +137,7 @@ func (r Ref) Validate() error {
|
||||
// IsZero 报告这条事实是零值(= 这条消息不是语音消息)。
|
||||
func (r Ref) IsZero() bool {
|
||||
return r.Source == "" && r.Status == "" && r.Name == "" && r.MIME == "" &&
|
||||
r.Size == 0 && r.DurationMs == 0
|
||||
r.Size == 0 && r.DurationMs == 0 && r.FallbackReason == ""
|
||||
}
|
||||
|
||||
// Encode 把一条语音事实编码成落库用的 JSON 单对象。零值返回 ""(⇒ 列里空串 ⇒ DTO 里
|
||||
@@ -167,7 +180,9 @@ func Decode(raw string) (Ref, error) {
|
||||
}
|
||||
|
||||
// validSource / validStatus 是闭集判定,只此一处(编码、解码与渲染共用)。
|
||||
func validSource(s Source) bool { return s == SourceASR || s == SourcePlatform }
|
||||
func validSource(s Source) bool {
|
||||
return s == SourceASR || s == SourcePlatform || s == SourceTTS
|
||||
}
|
||||
|
||||
func validStatus(s Status) bool {
|
||||
return s == StatusTranscribed || s == StatusEmpty || s == StatusFailed
|
||||
|
||||
Reference in new issue
Block a user