94 lines
2.7 KiB
Protocol Buffer
94 lines
2.7 KiB
Protocol Buffer
|
syntax = "proto3";
|
|||
|
|
|
|||
|
|
// 自动生成代码时的命名空间
|
|||
|
|
option csharp_namespace = "SHH.Contracts.Grpc";
|
|||
|
|
|
|||
|
|
service GatewayProvider {
|
|||
|
|
// 1. 身份注册 (CameraService -> AiVideo)
|
|||
|
|
rpc RegisterInstance (RegisterRequest) returns (GenericResponse);
|
|||
|
|
|
|||
|
|
// 2. 状态批量上报 (CameraService -> AiVideo)
|
|||
|
|
rpc ReportStatusBatch (StatusBatchRequest) returns (GenericResponse);
|
|||
|
|
|
|||
|
|
// 3. 视频流传输 (双向或客户端流)
|
|||
|
|
rpc UploadVideoStream (stream VideoFrameRequest) returns (GenericResponse);
|
|||
|
|
|
|||
|
|
// ★ 4. 指令推送通道 (Server Streaming)
|
|||
|
|
// 客户端启动后调用此方法并保持连接，服务端通过此流下发 Sync_Camera 等指令
|
|||
|
|
rpc OpenCommandChannel (CommandStreamRequest) returns (stream CommandPayloadProto);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- 1. 注册相关 ---
|
|||
|
|
message RegisterRequest {
|
|||
|
|
// 进程 ID (用于区分同一台机器上的多个实例)
|
|||
|
|
int32 process_id = 1;
|
|||
|
|
// 调用进程句柄
|
|||
|
|
int32 invoke_process_id = 2;
|
|||
|
|
// 实例唯一标识符 (例如 "Stream_1")
|
|||
|
|
string instance_id = 3;
|
|||
|
|
// 软件版本号
|
|||
|
|
string version = 4;
|
|||
|
|
// 软件所在的局域网 IP
|
|||
|
|
string server_ip = 5;
|
|||
|
|
// WebAPI 监听端口
|
|||
|
|
int32 webapi_port = 6;
|
|||
|
|
// Grpc通讯端口
|
|||
|
|
int32 grpc_port = 7;
|
|||
|
|
// 启动时间
|
|||
|
|
int64 start_time_ticks = 9;
|
|||
|
|
// 描述信息
|
|||
|
|
string description = 10;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- 2. 状态上报相关 ---
|
|||
|
|
message StatusBatchRequest {
|
|||
|
|
string protocol = 1;
|
|||
|
|
int64 timestamp = 2;
|
|||
|
|
repeated StatusEventItem items = 3;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
message StatusEventItem {
|
|||
|
|
string camera_id = 1;
|
|||
|
|
bool is_online = 2;
|
|||
|
|
string reason = 3;
|
|||
|
|
int64 timestamp = 4;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- 3. 视频流相关 ---
|
|||
|
|
message VideoFrameRequest {
|
|||
|
|
string camera_id = 1;
|
|||
|
|
int64 capture_timestamp = 2;
|
|||
|
|
int64 dispatch_timestamp = 3;
|
|||
|
|
int32 original_width = 4;
|
|||
|
|
int32 original_height = 5;
|
|||
|
|
int32 target_width = 6;
|
|||
|
|
int32 target_height = 7;
|
|||
|
|
repeated string subscriber_ids = 8;
|
|||
|
|
map<string, string> diagnostics = 9;
|
|||
|
|
bool has_original_image = 10;
|
|||
|
|
bool has_target_image = 11;
|
|||
|
|
bytes original_image_bytes = 12;
|
|||
|
|
bytes target_image_bytes = 13;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- 4. 指令下发相关 (对应 C# CommandPayload) ---
|
|||
|
|
message CommandStreamRequest {
|
|||
|
|
string instance_id = 1; // 告知服务端我是哪个节点
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
message CommandPayloadProto {
|
|||
|
|
string protocol = 1; // 协议类型，默认 "COMMAND"
|
|||
|
|
string cmd_code = 2; // 指令代码，如 "Sync_Camera"
|
|||
|
|
string target_id = 3; // 目标对象 ID
|
|||
|
|
string json_params = 4; // 业务参数 JSON
|
|||
|
|
string request_id = 5; // 请求追踪 ID
|
|||
|
|
int64 timestamp_ticks = 6; // 发送时间戳 (Ticks)
|
|||
|
|
bool require_ack = 7; // 是否需要回执
|
|||
|
|
int32 retry_count = 8; // 重试计数
|
|||
|
|
int64 expire_time = 9; // 过期时间戳
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
message GenericResponse {
|
|||
|
|
bool success = 1;
|
|||
|
|
string message = 2;
|
|||
|
|
}
|