# GB28181

**Repository Path**: AndroidCoderPeng/GB28181

## Basic Information

- **Project Name**: GB28181
- **Description**: GB/T 28181-2016协议推流
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-08-26
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android平台（Java/Kotlin/C++）GB/T 28181-2016推流流程说明

## 1. 初始化 SIP 参数并注册到国标平台

- 在 Java 层初始化 SIP 相关参数（如设备 ID、服务器地址、端口等），并通过 JNI 传递至 Native 层；
- Native 层使用 eXosip2 库向国标平台（GB/T 28181）发起注册请求；
- 注册成功后，记录程序启动的微秒级时间戳（即 `System.nanoTime() / 1000`），作为后续音视频帧时间戳的基准。

## 2. 视频采集与编码

- 使用 Camera1 API 采集视频画面，获取 YUV (NV21) 格式的原始数据；
- 将 NV21 转换为 NV12（适配硬件编码器输入要求）；
- 通过硬件编码器生成完整的 H.264 帧数据，必须包含起始码（Start Code: `0x00000001`）；
  > ⚠️ 关键提示：若 H.264 帧缺少起始码，PS 封装将失败或平台无法解析，导致推流无画面！
- 记录每帧编码完成时的时间戳（单位：微秒），相对于步骤 1 中的起始时间。

## 3. 音频采集

- 使用 AudioRecord 采集原始 PCM 裸流（通常为 16-bit、单声道、8kHz）；
- 同样记录每帧音频数据的时间戳（单位：微秒），相对于步骤 1 中的起始时间。

## 4. 拉流信令控制推流启停

- 客户端默认仅进行本地预览，不进行编码与推流；
- 当国标平台下发 拉流信令（Invite 请求） 后，客户端才开始：
    - 启动音视频编码；
    - 封装并推送媒体流；

## 5. 视频帧封装为 PS 流（这一步坑超多！！！）

- 通过 JNI 将 H.264 帧数据传递至 Native 层，将微秒级时间戳转为90kHz（uint64_t pts_90kHz = pts_us *
  90 / 1000）时间基准的时间戳。
  > ⚠️ 关键提示：GB/T 28181要求必须是90kHz下的时间基准，否则推流将无画面！
- 将整帧 H.264 数据按照起始码拆分为 NALU（网络应用层单元，是H.264数据的基本单元），同时提取 SPS/PPS
  帧数据并缓存，并把IDR帧筛选出来。
- 将 SPS/PPS 以及筛选选出来IDR帧的按照顺序【**`[起始码]+[SPS]+[PPS]+[IDR 帧]`**】组帧，并封装为 PES 包。
- 将非IDR帧的按照顺序【**`[起始码]+[P 帧]`**】组帧，并封装为 PES 包。
  > ⚠️ 关键提示：上面提到的IDR帧和P帧本质上是一系列 NALU ，IDR帧必须要比任何帧先发送到平台，
  > 否则平台不解析画面帧数据，因为SPS/PPS携带这视频帧的基本信息。
- 将上述步骤得到的数据——即 PES 包作为载荷，按照IDR帧（添加系统头和PSM）和非IDR帧封装为PS流。
  > ⚠️ 关键提示：添加系统头和PSM的时候，坑超多！每个字节，每个Bit位都得清楚是什么含义，否则无法正确封装！

## 6. 音频帧编码与封装为 PS 流

- 通过 JNI 将 PCM 裸流传递至 Native 层，将微秒级时间戳转为90kHz（uint64_t pts_90kHz = pts_us *
  90 / 1000）时间基准的时间戳。
  > ⚠️ 关键提示：GB/T 28181要求必须是90kHz下的时间基准，否则推流音画不同步！
- 在 Native 层将 PCM 编码为 G.711μ（G.711a）；
- 将整帧的 G.711μ（G.711a）并封装为 PES 包。音频封装较简单，直接塞进到 PES 包中即可。
- 将上述步骤得到的数据——即 PES 包作为载荷，封装为PS流。
  > ⚠️ 关键提示：音频帧全是非IDR帧，即，不用添加系统头和PSM和起始码。这里一定要注意！！！

## 7. PS 包分片处理

- 由于 RTP MTU 限制约为 1400 字节，需对较大的 PS 包进行分片；
- 判断每个 PS 包大小：
    - 若 ≤ 1400 字节：直接作为单个 RTP 包发送；
    - 若 > 1400 字节：按 RFC 3984 或 GB/T 28181 规范进行 RTP 分片封装。
- 这一步没什么坑，就是把PS 包进行分片，并封装为 RTP
  包，不过要注意Sip的sdp消息里面是要求设备以什么方式发送到平台，一定要按照sdp里面的方式发送，否则平台收不到包。

## 8. 网络传输

- 将封装好的 RTP 包（单包或分片）通过 TCP 或 UDP 发送至国标平台：
    - TCP 模式：连接可靠、抗丢包，适合网络不稳定环境；
    - UDP 模式：延迟更低，适合实时性要求高的场景；
- 传输协议类型由平台信令协商确定，客户端动态适配。