级联客户端：注册到上级平台

platform/cascade 让你的平台成为 GB/T 28181 级联中的下级平台：向上注册、上传聚合目录、把 INVITE 转发为流、从你的录像提供回放。

安装

go get github.com/mickeyzzc/gb28181-go@v0.11.0

Config

cfg := cascade.Config{
    Enabled:       true,
    ServerDomain:  "34020000002000000001", // 上级平台的国标 ID
    ServerAddr:    "192.0.2.20:5060",      // 上级平台 SIP 地址
    LocalDeviceID: "34020000002000000002", // 本平台对上的国标 ID
    Realm:         "3402000000",
    Password:      "secret",
    SIPListen:     ":5061",                // 级联客户端自己的 SIP 端口
    UserAgent:     "",                     // "" = "gb28181-go/cascade"
}

目录身份默认中性（厂商/型号 Unknown），经 CatalogDefaultManufacturer / CatalogDefaultModel 覆盖——你的级联播报的是你的品牌，不是库的。

宿主接缝——全部注入

type CameraSource interface {
    Cameras() []CameraInfo               // 本地相机清单
    Hub(cameraID string) *platform.FrameHub // 每台相机的实时帧
}

type Store interface {
    UpsertCascadeChannel(ctx, CascadeChannel) error
    ListCascadeChannels(ctx) ([]CascadeChannel, error)
    ListRecordings(ctx, RecordingFilter) ([]Recording, error)
}

接线与启动：

svc := cascade.New(cfg, cameraSource, store)
// 可选:按需子码流层
svc.SetSubStreamAcquirer(subAcquirer)
// 从录像段回放:
svc.SetSegmentParser(segmentParser)
svc.Start(ctx)

SegmentParser 从你的录像管线供给回放：每个段文件产出 SegmentInfo（编码 + 参数集 + 带时间戳的 sample）；fMP4 管线的宿主用一个薄包装适配自己的解析器即可（字段名已对齐）。

上级平台看到什么

目录——你的相机作为通道上报，通道 ID 按首次出现保持稳定 （向上身份跨重启不变）。
直播——上级的 INVITE 订阅你的 FrameHub，经 psmux 推 RTP/PS 上行（UDP 或 TCP）。
回放——RecordInfo 来自你的 Store；回放 INVITE 把录像段灌进同一条媒体路径。
信令——BYE/SUBSCRIBE/MESSAGE/INFO/OPTIONS 全部应答。

sequenceDiagram
    participant U as 上级平台
    participant C as cascade（下级平台）
    participant L as CameraSource / Store（宿主）
    C->>U: REGISTER（摘要认证，LocalDeviceID）
    U-->>C: 401（challenge）/ 200 OK
    C->>U: MESSAGE Catalog 上报（通道 ID 首见后保持稳定）
    U-->>C: 200 OK
    U->>C: INVITE（点播通道）
    C->>L: Hub(cameraID) 订阅实时帧
    C-->>U: 200 OK（SDP 应答）
    C->>U: RTP/PS 上行（psmux，UDP 或 TCP）
    U->>C: MESSAGE RecordInfo（回放查询）
    C->>L: ListRecordings(filter)
    C-->>U: MESSAGE 应答（录像清单）
    U->>C: INVITE（回放）
    C->>U: RTP/PS（录像段，同一媒体路径）
    U->>C: BYE
    C-->>U: 200 OK

支持多个上级平台（upstreams 配置）；每个是共享 listener 上的独立注册会话。