sequenceDiagram

    autonumber

    participant A as Peer A（主叫）

    participant S as 信令服务器

    participant B as Peer B（被叫）

    participant ICE as STUN/TURN 服务器

    Note over A: 创建 RTCPeerConnection<br/>添加媒体轨道或 DataChannel

    A->>A: createOffer()

    A->>A: setLocalDescription(offer)

    A->>S: 发送 SDP Offer

    S->>B: 转发 SDP Offer

    B->>B: setRemoteDescription(offer)

    B->>B: createAnswer()

    B->>B: setLocalDescription(answer)

    B->>S: 发送 SDP Answer

    S->>A: 转发 SDP Answer

    A->>A: setRemoteDescription(answer)

    par Peer A 收集 ICE Candidate

        A->>ICE: STUN Binding / TURN Allocate

        ICE-->>A: 返回候选地址

        A->>S: 发送 ICE Candidate

        S->>B: 转发 ICE Candidate

    and Peer B 收集 ICE Candidate

        B->>ICE: STUN Binding / TURN Allocate

        ICE-->>B: 返回候选地址

        B->>S: 发送 ICE Candidate

        S->>A: 转发 ICE Candidate

    end

    Note over A,B: ICE 连通性检查，选择最优候选对<br/>可能是直连，也可能经 TURN 中继

    A->>B: STUN Binding Request

    B-->>A: STUN Binding Success

    B->>A: STUN Binding Request

    A-->>B: STUN Binding Success

    Note over A,B: 在选定的候选对上执行 DTLS 握手

    A->>B: DTLS ClientHello

    B-->>A: DTLS ServerHello / Certificate / KeyExchange

    A->>B: DTLS Finished

    B-->>A: DTLS Finished

    alt 媒体通信

        Note over A,B: 从 DTLS 导出 SRTP 密钥

        A-->>B: SRTP/RTP 媒体流

        B-->>A: SRTP/RTP 媒体流

    else DataChannel 通信

        Note over A,B: 在 DTLS 上建立 SCTP 关联

        A-->>B: SCTP/DataChannel 数据

        B-->>A: SCTP/DataChannel 数据

    end

    Note over A,B: ICE/DTLS 完成，连接状态 connected

sequenceDiagram

    participant C as 客户端<br/>内网 192.168.1.10:54321

    participant N as NAT

    participant S as STUN 服务器<br/>公网

    C->>N: 1. 发送 STUN Binding Request<br/>源地址：192.168.1.10:54321

    N->>S: 2. 转发请求<br/>NAT 将源地址改为公网地址 xxxx:80304

    Note over S: 3. STUN 服务器看到源地址<br/>xxxx:80304

    S->>N: 4. 返回 Binding Response<br/>包含 XOR-MAPPED-ADDRESS = xxxx:80304

    N->>C: 5. 转发响应

    Note over C: 6. 客户端得到自己的公网映射地址<br/>作为 srflx 候选

sequenceDiagram

    participant A as Peer A

    participant NATA as NAT A

    participant NATB as NAT B

    participant B as Peer B

    Note over A,B: 前置：通过信令交换 SDP 和 ICE 候选

    Note over A,B: 双方各自获得 host / srflx / relay 候选

    Note over A,B: 假设双方选择 srflx 候选进行直连尝试

    A->>NATA: 发送 STUN 请求到 B 的公网地址

    NATA->>NATB: 出站包，NAT A 创建映射

    NATB->>B: 转发到 B

    B->>NATB: 发送 STUN 请求到 A 的公网地址

    NATB->>NATA: 出站包，NAT B 创建映射

    NATA->>A: 转发到 A

    B-->>A: STUN 响应

    A-->>B: STUN 响应

    Note over A,B: 双方 NAT 都允许对方入站，打洞成功

    A->>B: DTLS 握手

    B->>A: DTLS 握手

    Note over A,B: 密钥协商完成

    A->>B: SRTP / SRTCP 媒体流

    B->>A: SRTP / SRTCP 媒体流

    Note over A,B: 直连建立，媒体不经过服务器

sequenceDiagram

    participant A as 客户端 A

    participant T as TURN 服务器

    participant B as 客户端 B

    Note over A,T: 阶段一：A 向 TURN 申请中继地址

    A->>T: 1. Allocate 请求（认证）

    T-->>A: 2. 分配成功，返回 A 的中继地址<br/>Relay-A = 198.51.100.7:60000

    Note over B,T: 阶段二：B 向 TURN 申请中继地址

    B->>T: 3. Allocate 请求（认证）

    T-->>B: 4. 分配成功，返回 B 的中继地址<br/>Relay-B = 198.51.100.7:60001

    Note over A,B: 阶段三：通过信令交换中继地址

    A->>B: 5. 信令：A 告诉 B 自己的中继地址 Relay-A

    B->>A: 6. 信令：B 告诉 A 自己的中继地址 Relay-B

    Note over A,T: 阶段四：A 向 B 发送数据（媒体或 DataChannel）

    A->>T: 7. CreatePermission 请求<br/>允许 B 的地址

    T-->>A: 8. 权限创建成功

    A->>T: 9. Send Indication / ChannelData<br/>目标：Relay-B，负载：媒体数据

    T->>B: 10. 通过 B 与 TURN 的连接转发数据

    Note over B,T: 阶段五：B 向 A 发送数据

    B->>T: 11. CreatePermission 请求<br/>允许 A 的地址

    T-->>B: 12. 权限创建成功

    B->>T: 13. Send Indication / ChannelData<br/>目标：Relay-A，负载：媒体数据

    T->>A: 14. 通过 A 与 TURN 的连接转发数据

    Note over A,B: 后续媒体流持续通过 TURN 中继

flowchart TD

    A[开始收集] --> B[host 候选<br/>本机网卡地址]

    A --> C[向 STUN 请求]

    C --> D[srflx 候选<br/>NAT 公网映射]

    A --> E[向 TURN 申请]

    E --> F[relay 候选<br/>TURN 中继地址]

    B & D & F --> G[通过信令交换]

    G --> H[形成候选对]

    H --> I[连通性检查]

    I --> J{是否成功?}

    J -- 是 --> K[提名并选中]

    J -- 否 --> L[尝试下一候选对]

    L --> I

    K --> M[媒体传输]