联犀开发者文档

后台休眠弱网与状态同步：完整报文

约 749 字大约 3 分钟

2026-10-16

本页是场景流程的完整 JSON 序列，按图中编号查阅。示例中的分支互斥，不能顺序重放全部报文；实际 ID、截止、SDP、地址和密钥须由运行时取得。实施状态及字段定义仍以场景与命令页为准。

编号报文

M01 · sessionSync

{
  "msgToken": "s19-72",
  "method": "sessionSync",
  "sessionId": "s19-session",
  "params": {
    "lastEventSeq": 12,
    "lastMessageSeq": 8,
    "endpointEpoch": 1,
    "mediaRevision": 1
  }
}

M02 · sessionSnapshot

{
  "msgToken": "s19-72",
  "method": "sessionSnapshot",
  "sessionId": "s19-session",
  "data": {
    "state": "established",
    "revision": 5,
    "eventWatermark": 18,
    "messageWatermark": 10,
    "endpointEpoch": 1,
    "mediaRevision": 1,
    "tracks": [
      {
        "trackId": "mic",
        "kind": "audio",
        "sourceId": "mic",
        "sourceType": "microphone",
        "direction": "sendonly",
        "codec": "opus",
        "state": "requested"
      }
    ],
    "controls": {
      "call": {
        "state": "active",
        "revision": 1
      },
      "focus": {
        "state": "suspended",
        "revision": 2,
        "focusId": "focus-before-sleep",
        "resources": [
          "microphone",
          "speaker"
        ]
      },
      "floor": null,
      "recordings": [],
      "playbacks": [],
      "processors": [],
      "mediaPlan": {
        "revision": 0,
        "tracks": [
          {
            "trackId": "mic",
            "kind": "audio",
            "sourceId": "mic",
            "sourceType": "microphone",
            "direction": "sendonly",
            "codec": "opus",
            "state": "requested"
          }
        ]
      },
      "broadcasts": [],
      "handoffs": [],
      "ai": null
    },
    "resumeAllowed": true,
    "capabilityRevision": 1
  },
  "code": 200
}

M03 · mediaOffer

{
  "msgToken": "s19-73",
  "method": "mediaOffer",
  "sessionId": "s19-session",
  "params": {
    "mediaRevision": 2,
    "webrtc": {
      "iceMode": "complete",
      "sdp": "<SDP offer>"
    }
  }
}

M04 · mediaAnswer

{
  "msgToken": "s19-73",
  "method": "mediaAnswer",
  "sessionId": "s19-session",
  "data": {
    "mediaRevision": 2,
    "webrtc": {
      "iceMode": "complete",
      "sdp": "<SDP answer>"
    }
  },
  "code": 200
}

M05 · mediaState

{
  "msgToken": "s19-74",
  "method": "mediaState",
  "sessionId": "s19-session",
  "params": {
    "mediaRevision": 2,
    "state": "connected"
  }
}

M06 · requestAck

{
  "msgToken": "s19-74",
  "method": "requestAck",
  "sessionId": "s19-session",
  "data": {
    "requestMethod": "mediaState",
    "result": {
      "mediaRevision": 2,
      "state": "connected"
    }
  },
  "code": 200
}

M07 · sessionEstablished

{
  "msgToken": "s19-75",
  "method": "sessionEstablished",
  "sessionId": "s19-session",
  "data": {
    "state": "established",
    "mediaRevision": 2
  },
  "eventSeq": 19
}

M08 · mediaUpdate

{
  "msgToken": "s19-76",
  "method": "mediaUpdate",
  "sessionId": "s19-session",
  "params": {
    "operation": "setQuality",
    "expectedRevision": 0,
    "trackIds": [
      "mic"
    ],
    "profile": "low"
  }
}

M12 · mediaUpdated

{"msgToken":"s19-76","method":"mediaUpdated","sessionId":"s19-session","code":200,"data":{"state":"pending","revision":1,"mediaRevision":2,"tracks":[{"trackId":"mic","kind":"audio","sourceId":"mic","direction":"sendonly","codec":"opus","state":"active"}]}}

M11 · trackState

{
  "msgToken": "s19-quality-observed",
  "method": "trackState",
  "sessionId": "s19-session",
  "data": {
    "trackId": "mic",
    "state": "active",
    "mediaRevision": 2,
    "requestToken": "s19-76",
    "revision": 1
  }
}

M13 · requestAck

{"msgToken":"s19-quality-observed","method":"requestAck","sessionId":"s19-session","code":200,"data":{"requestMethod":"trackState","result":{"trackId":"mic","state":"active","mediaRevision":2}}}

M09 · mediaUpdated

{
  "msgToken": "s19-quality-applied",
  "method": "mediaUpdated",
  "sessionId": "s19-session",
  "eventSeq": 20,
  "data": {
    "state": "applied",
    "revision": 1,
    "mediaRevision": 2,
    "tracks": [
      {
        "trackId": "mic",
        "kind": "audio",
        "sourceId": "mic",
        "sourceType": "microphone",
        "direction": "sendonly",
        "codec": "opus",
        "state": "active"
      }
    ],
    "requestToken": "s19-76"
  }
}

M15 · mediaUpdated

{"msgToken":"s19-quality-failed","method":"mediaUpdated","sessionId":"s19-session","eventSeq":20,"data":{"state":"failed","revision":1,"requestToken":"s19-76","reason":"qualityTimeout"}}

M14 · mediaUpdated

{"msgToken":"s19-76","method":"mediaUpdated","sessionId":"s19-session","code":409,"data":{"reason":"updatePending","currentRevision":1}}

M10 · sessionSnapshot

{
  "msgToken": "s19-72",
  "method": "sessionSnapshot",
  "sessionId": "s19-session",
  "data": {
    "state": "ended",
    "revision": 6,
    "eventWatermark": 19,
    "messageWatermark": 10,
    "endpointEpoch": 1,
    "mediaRevision": 1,
    "tracks": [],
    "controls": {
      "call": null,
      "focus": null,
      "floor": null,
      "recordings": [],
      "playbacks": [],
      "processors": [],
      "mediaPlan": {
        "revision": 0,
        "tracks": []
      },
      "broadcasts": [],
      "handoffs": [],
      "ai": null
    },
    "resumeAllowed": false,
    "reason": "sessionExpired",
    "capabilityRevision": 1
  },
  "code": 200
}

更新日志

2026/10/17 03:27
查看所有更新日志
  • d04e1-docs(AI与音视频): 按公共主线与场景分支整合接入手册于