| | |
| | | import com.genersoft.iot.vmp.conf.DynamicTask; |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.media.zlm.SendRtpPortManager; |
| | | import com.genersoft.iot.vmp.media.zlm.ZLMServerFactory; |
| | | import com.genersoft.iot.vmp.media.zlm.ZlmHttpHookSubscribe; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.RecordFile; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.apache.commons.lang3.ObjectUtils; |
| | | import org.slf4j.Logger; |
| | |
| | | |
| | | @ResponseBody |
| | | @GetMapping("/date/list") |
| | | @Operation(summary = "查询存在云端录像的日期") |
| | | @Operation(summary = "查询存在云端录像的日期", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流ID", required = true) |
| | | @Parameter(name = "year", description = "年,置空则查询当年", required = false) |
| | |
| | | |
| | | @ResponseBody |
| | | @GetMapping("/list") |
| | | @Operation(summary = "分页查询云端录像") |
| | | @Operation(summary = "分页查询云端录像", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流ID", required = true) |
| | | @Parameter(name = "page", description = "当前页", required = false) |
| | |
| | | package com.genersoft.iot.vmp.vmanager.gb28181.MobilePosition; |
| | | |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.bean.MobilePosition; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.DeferredResultHolder; |
| | |
| | | import com.github.pagehelper.util.StringUtil; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * @param end 结束时间 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "查询历史轨迹") |
| | | @Operation(summary = "查询历史轨迹", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号") |
| | | @Parameter(name = "start", description = "开始时间") |
| | |
| | | * @param deviceId 设备ID |
| | | * @return |
| | | */ |
| | | @Operation(summary = "查询设备最新位置") |
| | | @Operation(summary = "查询设备最新位置", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/latest/{deviceId}") |
| | | public MobilePosition latestPosition(@PathVariable String deviceId) { |
| | |
| | | * @param deviceId 设备ID |
| | | * @return |
| | | */ |
| | | @Operation(summary = "获取移动位置信息") |
| | | @Operation(summary = "获取移动位置信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/realtime/{deviceId}") |
| | | public DeferredResult<MobilePosition> realTimePosition(@PathVariable String deviceId) { |
| | |
| | | * @param interval 上报时间间隔 |
| | | * @return true = 命令发送成功 |
| | | */ |
| | | @Operation(summary = "订阅位置信息") |
| | | @Operation(summary = "订阅位置信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "expires", description = "订阅超时时间", required = true) |
| | | @Parameter(name = "interval", description = "上报时间间隔", required = true) |
| | |
| | | * @param deviceId 设备ID |
| | | * @return true = 命令发送成功 |
| | | */ |
| | | @Operation(summary = "数据位置信息格式处理") |
| | | @Operation(summary = "数据位置信息格式处理", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/transform/{deviceId}") |
| | | public void positionTransform(@PathVariable String deviceId) { |
| | |
| | | package com.genersoft.iot.vmp.vmanager.gb28181.alarm; |
| | | |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.bean.DeviceAlarm; |
| | | import com.genersoft.iot.vmp.gb28181.bean.ParentPlatform; |
| | |
| | | import com.github.pagehelper.PageInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * @return |
| | | */ |
| | | @DeleteMapping("/delete") |
| | | @Operation(summary = "删除报警") |
| | | @Operation(summary = "删除报警", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "id", description = "ID") |
| | | @Parameter(name = "deviceIds", description = "多个设备id,逗号分隔") |
| | | @Parameter(name = "time", description = "结束时间") |
| | |
| | | * @return |
| | | */ |
| | | @GetMapping("/test/notify/alarm") |
| | | @Operation(summary = "测试向上级/设备发送模拟报警通知") |
| | | @Operation(summary = "测试向上级/设备发送模拟报警通知", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号") |
| | | public void delete(@RequestParam String deviceId) { |
| | | Device device = storage.queryVideoDevice(deviceId); |
| | |
| | | * @param endTime 结束时间 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "分页查询报警") |
| | | @Operation(summary = "分页查询报警", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page",description = "当前页",required = true) |
| | | @Parameter(name = "count",description = "每页查询数量",required = true) |
| | | @Parameter(name = "deviceId",description = "设备id") |
| | |
| | | |
| | | import com.alibaba.fastjson2.JSONObject; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.DeferredResultHolder; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.RequestMessage; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.ErrorCode; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * @return |
| | | */ |
| | | @GetMapping("/basicParam/{deviceId}") |
| | | @Operation(summary = "基本配置设置命令") |
| | | @Operation(summary = "基本配置设置命令", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "name", description = "名称") |
| | |
| | | * @param channelId 通道ID |
| | | * @return |
| | | */ |
| | | @Operation(summary = "设备配置查询请求") |
| | | @Operation(summary = "设备配置查询请求", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "configType", description = "配置类型") |
| | |
| | | |
| | | import com.alibaba.fastjson2.JSONObject; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.DeferredResultHolder; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.RequestMessage; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.ErrorCode; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * |
| | | * @param deviceId 设备ID |
| | | */ |
| | | @Operation(summary = "远程启动控制命令") |
| | | @Operation(summary = "远程启动控制命令", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/teleboot/{deviceId}") |
| | | public void teleBootApi(@PathVariable String deviceId) { |
| | |
| | | * @param recordCmdStr Record:手动录像,StopRecord:停止手动录像 |
| | | * @param channelId 通道编码(可选) |
| | | */ |
| | | @Operation(summary = "录像控制") |
| | | @Operation(summary = "录像控制", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "recordCmdStr", description = "命令, 可选值:Record(手动录像),StopRecord(停止手动录像)", required = true) |
| | |
| | | * @param deviceId 设备ID |
| | | * @param guardCmdStr SetGuard:布防,ResetGuard:撤防 |
| | | */ |
| | | @Operation(summary = "布防/撤防命令") |
| | | @Operation(summary = "布防/撤防命令", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "guardCmdStr", description = "命令, 可选值:SetGuard(布防),ResetGuard(撤防)", required = true) |
| | | @GetMapping("/guard/{deviceId}/{guardCmdStr}") |
| | |
| | | * @param alarmMethod 报警方式(可选) |
| | | * @param alarmType 报警类型(可选) |
| | | */ |
| | | @Operation(summary = "报警复位") |
| | | @Operation(summary = "报警复位", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "alarmMethod", description = "报警方式") |
| | |
| | | * @param deviceId 设备ID |
| | | * @param channelId 通道ID |
| | | */ |
| | | @Operation(summary = "强制关键帧") |
| | | @Operation(summary = "强制关键帧", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号") |
| | | @GetMapping("/i_frame/{deviceId}") |
| | |
| | | * @param presetIndex 调用预置位编号(可选) |
| | | * @param channelId 通道编码(可选) |
| | | */ |
| | | @Operation(summary = "看守位控制") |
| | | @Operation(summary = "看守位控制", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "enabled", description = "是否开启看守位 1:开启,0:关闭", required = true) |
| | |
| | | * @param lengthy 拉框宽度像素值 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "拉框放大") |
| | | @Operation(summary = "拉框放大", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "length", description = "播放窗口长度像素值", required = true) |
| | |
| | | * @param lengthy 拉框宽度像素值 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "拉框放大") |
| | | @Operation(summary = "拉框缩小", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号") |
| | | @Parameter(name = "length", description = "播放窗口长度像素值", required = true) |
| | |
| | | import com.alibaba.fastjson2.JSONObject; |
| | | import com.genersoft.iot.vmp.conf.DynamicTask; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.bean.DeviceChannel; |
| | | import com.genersoft.iot.vmp.gb28181.bean.SyncStatus; |
| | |
| | | import com.github.pagehelper.PageInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.apache.commons.compress.utils.IOUtils; |
| | | import org.apache.ibatis.annotations.Options; |
| | |
| | | * @param deviceId 国标ID |
| | | * @return 国标设备 |
| | | */ |
| | | @Operation(summary = "查询国标设备") |
| | | @Operation(summary = "查询国标设备", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/devices/{deviceId}") |
| | | public Device devices(@PathVariable String deviceId){ |
| | |
| | | * @param count 每页查询数量 |
| | | * @return 分页国标列表 |
| | | */ |
| | | @Operation(summary = "分页查询国标设备") |
| | | @Operation(summary = "分页查询国标设备", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | | @Parameter(name = "count", description = "每页查询数量", required = true) |
| | | @GetMapping("/devices") |
| | |
| | | * @return 通道列表 |
| | | */ |
| | | @GetMapping("/devices/{deviceId}/channels") |
| | | @Operation(summary = "分页查询通道") |
| | | @Operation(summary = "分页查询通道", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | | @Parameter(name = "count", description = "每页查询数量", required = true) |
| | |
| | | * @param deviceId 设备id |
| | | * @return |
| | | */ |
| | | @Operation(summary = "同步设备通道") |
| | | @Operation(summary = "同步设备通道", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/devices/{deviceId}/sync") |
| | | public WVPResult<SyncStatus> devicesSync(@PathVariable String deviceId){ |
| | |
| | | * @param deviceId 设备id |
| | | * @return |
| | | */ |
| | | @Operation(summary = "移除设备") |
| | | @Operation(summary = "移除设备", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @DeleteMapping("/devices/{deviceId}/delete") |
| | | public String delete(@PathVariable String deviceId){ |
| | |
| | | * @param channelType 通道类型 |
| | | * @return 子通道列表 |
| | | */ |
| | | @Operation(summary = "分页查询子目录通道") |
| | | @Operation(summary = "分页查询子目录通道", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | |
| | | * @param channel 通道 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "更新通道信息") |
| | | @Operation(summary = "更新通道信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channel", description = "通道信息", required = true) |
| | | @PostMapping("/channel/update/{deviceId}") |
| | |
| | | * @param streamMode 数据流传输模式 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "修改数据流传输模式") |
| | | @Operation(summary = "修改数据流传输模式", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "streamMode", description = "数据流传输模式, 取值:" + |
| | | "UDP(udp传输),TCP-ACTIVE(tcp主动模式,暂不支持),TCP-PASSIVE(tcp被动模式)", required = true) |
| | |
| | | * @param device 设备信息 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "添加设备信息") |
| | | @Operation(summary = "添加设备信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "device", description = "设备", required = true) |
| | | @PostMapping("/device/add/") |
| | | public void addDevice(Device device){ |
| | |
| | | * @param device 设备信息 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "更新设备信息") |
| | | @Operation(summary = "更新设备信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "device", description = "设备", required = true) |
| | | @PostMapping("/device/update/") |
| | | public void updateDevice(Device device){ |
| | |
| | | * |
| | | * @param deviceId 设备id |
| | | */ |
| | | @Operation(summary = "设备状态查询") |
| | | @Operation(summary = "设备状态查询", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/devices/{deviceId}/status") |
| | | public DeferredResult<ResponseEntity<String>> deviceStatusApi(@PathVariable String deviceId) { |
| | |
| | | * @param endTime 报警发生终止时间(可选) |
| | | * @return true = 命令发送成功 |
| | | */ |
| | | @Operation(summary = "设备状态查询") |
| | | @Operation(summary = "设备报警查询", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "startPriority", description = "报警起始级别") |
| | | @Parameter(name = "endPriority", description = "报警终止级别") |
| | |
| | | |
| | | |
| | | @GetMapping("/{deviceId}/sync_status") |
| | | @Operation(summary = "获取通道同步进度") |
| | | @Operation(summary = "获取通道同步进度", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | public WVPResult<SyncStatus> getSyncStatus(@PathVariable String deviceId) { |
| | | SyncStatus channelSyncStatus = deviceService.getChannelSyncStatus(deviceId); |
| | |
| | | } |
| | | |
| | | @GetMapping("/{deviceId}/subscribe_info") |
| | | @Operation(summary = "获取设备的订阅状态") |
| | | @Operation(summary = "获取设备的订阅状态", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | public WVPResult<Map<String, Integer>> getSubscribeInfo(@PathVariable String deviceId) { |
| | | Set<String> allKeys = dynamicTask.getAllKeys(); |
| | |
| | | package com.genersoft.iot.vmp.vmanager.gb28181.gbStream; |
| | | |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.GbStream; |
| | | import com.genersoft.iot.vmp.gb28181.bean.ParentPlatform; |
| | | import com.genersoft.iot.vmp.service.IGbStreamService; |
| | |
| | | import com.github.pagehelper.PageInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * @param platformId 平台ID |
| | | * @return |
| | | */ |
| | | @Operation(summary = "查询国标通道") |
| | | @Operation(summary = "查询国标通道", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | | @Parameter(name = "count", description = "每页条数", required = true) |
| | | @Parameter(name = "platformId", description = "平台ID", required = true) |
| | |
| | | * @param gbStreamParam |
| | | * @return |
| | | */ |
| | | @Operation(summary = "移除国标关联") |
| | | @Operation(summary = "移除国标关联", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @DeleteMapping(value = "/del") |
| | | @ResponseBody |
| | | public void del(@RequestBody GbStreamParam gbStreamParam){ |
| | |
| | | * @param gbStreamParam |
| | | * @return |
| | | */ |
| | | @Operation(summary = "保存国标关联") |
| | | @Operation(summary = "保存国标关联", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @PostMapping(value = "/add") |
| | | @ResponseBody |
| | | public void add(@RequestBody GbStreamParam gbStreamParam){ |
| | |
| | | * @param gbId |
| | | * @return |
| | | */ |
| | | @Operation(summary = "保存国标关联") |
| | | @Operation(summary = "保存国标关联", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @GetMapping(value = "/addWithGbid") |
| | | @ResponseBody |
| | | public void add(String gbId, String platformGbId, @RequestParam(required = false) String catalogGbId){ |
| | |
| | | |
| | | import com.genersoft.iot.vmp.common.StreamInfo; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.conf.security.SecurityUtils; |
| | | import com.genersoft.iot.vmp.conf.security.dto.LoginUser; |
| | | import com.genersoft.iot.vmp.media.zlm.dto.StreamAuthorityInfo; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.StreamContent; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * @param stream 流id |
| | | * @return |
| | | */ |
| | | @Operation(summary = "根据应用名和流id获取播放地址") |
| | | @Operation(summary = "根据应用名和流id获取播放地址", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流id", required = true) |
| | | @Parameter(name = "mediaServerId", description = "媒体服务器id") |
| | |
| | | import com.genersoft.iot.vmp.conf.DynamicTask; |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.ParentPlatform; |
| | | import com.genersoft.iot.vmp.gb28181.bean.ParentPlatformCatch; |
| | | import com.genersoft.iot.vmp.gb28181.bean.PlatformCatalog; |
| | |
| | | import com.github.pagehelper.PageInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * |
| | | * @return |
| | | */ |
| | | @Operation(summary = "获取国标服务的配置") |
| | | @Operation(summary = "获取国标服务的配置", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @GetMapping("/server_config") |
| | | public JSONObject serverConfig() { |
| | | JSONObject result = new JSONObject(); |
| | |
| | | * |
| | | * @return |
| | | */ |
| | | @Operation(summary = "获取级联服务器信息") |
| | | @Operation(summary = "获取级联服务器信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "id", description = "平台国标编号", required = true) |
| | | @GetMapping("/info/{id}") |
| | | public ParentPlatform getPlatform(@PathVariable String id) { |
| | |
| | | * @return |
| | | */ |
| | | @GetMapping("/query/{count}/{page}") |
| | | @Operation(summary = "分页查询级联平台") |
| | | @Operation(summary = "分页查询级联平台", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | | @Parameter(name = "count", description = "每页条数", required = true) |
| | | public PageInfo<ParentPlatform> platforms(@PathVariable int page, @PathVariable int count) { |
| | |
| | | * @param parentPlatform |
| | | * @return |
| | | */ |
| | | @Operation(summary = "添加上级平台信息") |
| | | @Operation(summary = "添加上级平台信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @PostMapping("/add") |
| | | @ResponseBody |
| | | public void addPlatform(@RequestBody ParentPlatform parentPlatform) { |
| | |
| | | * @param parentPlatform |
| | | * @return |
| | | */ |
| | | @Operation(summary = "保存上级平台信息") |
| | | @Operation(summary = "保存上级平台信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @PostMapping("/save") |
| | | @ResponseBody |
| | | public void savePlatform(@RequestBody ParentPlatform parentPlatform) { |
| | |
| | | * @param serverGBId 上级平台国标ID |
| | | * @return |
| | | */ |
| | | @Operation(summary = "删除上级平台") |
| | | @Operation(summary = "删除上级平台", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "serverGBId", description = "上级平台的国标编号") |
| | | @DeleteMapping("/delete/{serverGBId}") |
| | | @ResponseBody |
| | |
| | | * @param serverGBId 上级平台国标ID |
| | | * @return |
| | | */ |
| | | @Operation(summary = "查询上级平台是否存在") |
| | | @Operation(summary = "查询上级平台是否存在", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "serverGBId", description = "上级平台的国标编号") |
| | | @GetMapping("/exit/{serverGBId}") |
| | | @ResponseBody |
| | |
| | | * @param channelType 通道类型 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "查询上级平台是否存在") |
| | | @Operation(summary = "查询上级平台是否存在", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | | @Parameter(name = "count", description = "每页条数", required = true) |
| | | @Parameter(name = "platformId", description = "上级平台的国标编号") |
| | |
| | | * @param param 通道关联参数 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "向上级平台添加国标通道") |
| | | @Operation(summary = "向上级平台添加国标通道", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @PostMapping("/update_channel_for_gb") |
| | | @ResponseBody |
| | | public void updateChannelForGB(@RequestBody UpdateChannelParam param) { |
| | |
| | | * @param param 通道关联参数 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "从上级平台移除国标通道") |
| | | @Operation(summary = "从上级平台移除国标通道", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @DeleteMapping("/del_channel_for_gb") |
| | | @ResponseBody |
| | | public void delChannelForGB(@RequestBody UpdateChannelParam param) { |
| | |
| | | * @param parentId 目录父ID |
| | | * @return |
| | | */ |
| | | @Operation(summary = "获取目录") |
| | | @Operation(summary = "获取目录", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "platformId", description = "上级平台的国标编号", required = true) |
| | | @Parameter(name = "parentId", description = "父级目录的国标编号", required = true) |
| | | @GetMapping("/catalog") |
| | |
| | | * @param platformCatalog 目录 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "添加目录") |
| | | @Operation(summary = "添加目录", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @PostMapping("/catalog/add") |
| | | @ResponseBody |
| | | public void addCatalog(@RequestBody PlatformCatalog platformCatalog) { |
| | |
| | | * @param platformCatalog 目录 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "编辑目录") |
| | | @Operation(summary = "编辑目录", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @PostMapping("/catalog/edit") |
| | | @ResponseBody |
| | | public void editCatalog(@RequestBody PlatformCatalog platformCatalog) { |
| | |
| | | * @param platformId 平台Id |
| | | * @return |
| | | */ |
| | | @Operation(summary = "删除目录") |
| | | @Operation(summary = "删除目录", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "id", description = "目录Id", required = true) |
| | | @Parameter(name = "platformId", description = "平台Id", required = true) |
| | | @DeleteMapping("/catalog/del") |
| | |
| | | * @param platformCatalog 关联的信息 |
| | | * @return |
| | | */ |
| | | @Operation(summary = "删除关联") |
| | | @Operation(summary = "删除关联", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @DeleteMapping("/catalog/relation/del") |
| | | @ResponseBody |
| | | public void delRelation(@RequestBody PlatformCatalog platformCatalog) { |
| | |
| | | * @param catalogId 目录Id |
| | | * @return |
| | | */ |
| | | @Operation(summary = "修改默认目录") |
| | | @Operation(summary = "修改默认目录", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "catalogId", description = "目录Id", required = true) |
| | | @Parameter(name = "platformId", description = "平台Id", required = true) |
| | | @PostMapping("/catalog/default/update") |
| | |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.exception.SsrcTransactionNotFoundException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.bean.SsrcTransaction; |
| | | import com.genersoft.iot.vmp.gb28181.session.VideoStreamSessionManager; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.WVPResult; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | @Autowired |
| | | private UserSetting userSetting; |
| | | |
| | | @Operation(summary = "开始点播") |
| | | @Operation(summary = "开始点播", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @GetMapping("/start/{deviceId}/{channelId}") |
| | |
| | | return result; |
| | | } |
| | | |
| | | @Operation(summary = "停止点播") |
| | | @Operation(summary = "停止点播", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "isSubStream", description = "是否子码流(true-子码流,false-主码流),默认为false", required = true) |
| | |
| | | * 将不是h264的视频通过ffmpeg 转码为h264 + aac |
| | | * @param streamId 流ID |
| | | */ |
| | | @Operation(summary = "将不是h264的视频通过ffmpeg 转码为h264 + aac") |
| | | @Operation(summary = "将不是h264的视频通过ffmpeg 转码为h264 + aac", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "streamId", description = "视频流ID", required = true) |
| | | @PostMapping("/convert/{streamId}") |
| | | public JSONObject playConvert(@PathVariable String streamId) { |
| | |
| | | /** |
| | | * 结束转码 |
| | | */ |
| | | @Operation(summary = "结束转码") |
| | | @Operation(summary = "结束转码", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "key", description = "视频流key", required = true) |
| | | @Parameter(name = "mediaServerId", description = "流媒体服务ID", required = true) |
| | | @PostMapping("/convertStop/{key}") |
| | |
| | | } |
| | | } |
| | | |
| | | @Operation(summary = "语音广播命令") |
| | | @Operation(summary = "语音广播命令", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @GetMapping("/broadcast/{deviceId}") |
| | | @PostMapping("/broadcast/{deviceId}") |
| | |
| | | return result; |
| | | } |
| | | |
| | | @Operation(summary = "获取所有的ssrc") |
| | | @Operation(summary = "获取所有的ssrc", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @GetMapping("/ssrc") |
| | | public JSONObject getSSRC() { |
| | | if (logger.isDebugEnabled()) { |
| | |
| | | return jsonObject; |
| | | } |
| | | |
| | | @Operation(summary = "获取截图") |
| | | @Operation(summary = "获取截图", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "isSubStream", description = "是否子码流(true-子码流,false-主码流),默认为false", required = true) |
| | |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.exception.ServiceException; |
| | | import com.genersoft.iot.vmp.conf.exception.SsrcTransactionNotFoundException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.DeferredResultHolder; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.RequestMessage; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.WVPResult; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | @Autowired |
| | | private UserSetting userSetting; |
| | | |
| | | @Operation(summary = "开始视频回放") |
| | | @Operation(summary = "开始视频回放", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "startTime", description = "开始时间", required = true) |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "停止视频回放") |
| | | @Operation(summary = "停止视频回放", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "stream", description = "流ID", required = true) |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "回放暂停") |
| | | @Operation(summary = "回放暂停", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "streamId", description = "回放流ID", required = true) |
| | | @GetMapping("/pause/{streamId}") |
| | | public void playPause(@PathVariable String streamId) { |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "回放恢复") |
| | | @Operation(summary = "回放恢复", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "streamId", description = "回放流ID", required = true) |
| | | @GetMapping("/resume/{streamId}") |
| | | public void playResume(@PathVariable String streamId) { |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "回放拖动播放") |
| | | @Operation(summary = "回放拖动播放", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "streamId", description = "回放流ID", required = true) |
| | | @Parameter(name = "seekTime", description = "拖动偏移量,单位s", required = true) |
| | | @GetMapping("/seek/{streamId}/{seekTime}") |
| | |
| | | } |
| | | } |
| | | |
| | | @Operation(summary = "回放倍速播放") |
| | | @Operation(summary = "回放倍速播放", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "streamId", description = "回放流ID", required = true) |
| | | @Parameter(name = "speed", description = "倍速0.25 0.5 1、2、4", required = true) |
| | | @GetMapping("/speed/{streamId}/{speed}") |
| | |
| | | |
| | | |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.DeferredResultHolder; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.RequestMessage; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.ErrorCode; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * @param zoomSpeed 缩放速度 |
| | | */ |
| | | |
| | | @Operation(summary = "云台控制") |
| | | @Operation(summary = "云台控制", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "command", description = "控制指令,允许值: left, right, up, down, upleft, upright, downleft, downright, zoomin, zoomout, stop", required = true) |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "通用前端控制命令") |
| | | @Operation(summary = "通用前端控制命令", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "cmdCode", description = "指令码", required = true) |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "预置位查询") |
| | | @Operation(summary = "预置位查询", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @GetMapping("/preset/query/{deviceId}/{channelId}") |
| | |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.exception.SsrcTransactionNotFoundException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.bean.Device; |
| | | import com.genersoft.iot.vmp.gb28181.bean.RecordInfo; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.DeferredResultHolder; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.WVPResult; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | @Autowired |
| | | private UserSetting userSetting; |
| | | |
| | | @Operation(summary = "录像查询") |
| | | @Operation(summary = "录像查询", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "startTime", description = "开始时间", required = true) |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "开始历史媒体下载") |
| | | @Operation(summary = "开始历史媒体下载", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "startTime", description = "开始时间", required = true) |
| | |
| | | return result; |
| | | } |
| | | |
| | | @Operation(summary = "停止历史媒体下载") |
| | | @Operation(summary = "停止历史媒体下载", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "stream", description = "流ID", required = true) |
| | |
| | | } |
| | | } |
| | | |
| | | @Operation(summary = "获取历史媒体下载进度") |
| | | @Operation(summary = "获取历史媒体下载进度", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "deviceId", description = "设备国标编号", required = true) |
| | | @Parameter(name = "channelId", description = "通道国标编号", required = true) |
| | | @Parameter(name = "stream", description = "流ID", required = true) |
| | |
| | | |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.service.ILogService; |
| | | import com.genersoft.iot.vmp.storager.dao.dto.LogDto; |
| | | import com.genersoft.iot.vmp.utils.DateUtil; |
| | |
| | | import com.github.pagehelper.PageInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | * @return |
| | | */ |
| | | @GetMapping("/all") |
| | | @Operation(summary = "分页查询日志") |
| | | @Operation(summary = "分页查询日志", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "query", description = "查询内容", required = true) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | | @Parameter(name = "count", description = "每页查询数量", required = true) |
| | |
| | | * 清空日志 |
| | | * |
| | | */ |
| | | @Operation(summary = "清空日志") |
| | | @Operation(summary = "清空日志", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @DeleteMapping("/clear") |
| | | public void clear() { |
| | | logService.clear(); |
| | |
| | | import com.genersoft.iot.vmp.conf.DynamicTask; |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.media.zlm.SendRtpPortManager; |
| | | import com.genersoft.iot.vmp.media.zlm.ZLMServerFactory; |
| | | import com.genersoft.iot.vmp.media.zlm.ZlmHttpHookSubscribe; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.OtherPsSendInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import okhttp3.OkHttpClient; |
| | | import okhttp3.Request; |
| | |
| | | |
| | | @GetMapping(value = "/receive/open") |
| | | @ResponseBody |
| | | @Operation(summary = "开启收流和获取发流信息") |
| | | @Operation(summary = "开启收流和获取发流信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "isSend", description = "是否发送,false时只开启收流, true同时返回推流信息", required = true) |
| | | @Parameter(name = "callId", description = "整个过程的唯一标识,为了与后续接口关联", required = true) |
| | | @Parameter(name = "ssrc", description = "来源流的SSRC,不传则不校验来源ssrc", required = false) |
| | |
| | | |
| | | @GetMapping(value = "/receive/close") |
| | | @ResponseBody |
| | | @Operation(summary = "关闭收流") |
| | | @Operation(summary = "关闭收流", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "stream", description = "流的ID", required = true) |
| | | public void closeRtpServer(String stream) { |
| | | logger.info("[第三方PS服务对接->关闭收流] stream->{}", stream); |
| | |
| | | |
| | | @GetMapping(value = "/send/start") |
| | | @ResponseBody |
| | | @Operation(summary = "发送流") |
| | | @Operation(summary = "发送流", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "ssrc", description = "发送流的SSRC", required = true) |
| | | @Parameter(name = "dstIp", description = "目标收流IP", required = true) |
| | | @Parameter(name = "dstPort", description = "目标收流端口", required = true) |
| | |
| | | import com.genersoft.iot.vmp.conf.DynamicTask; |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.media.zlm.SendRtpPortManager; |
| | | import com.genersoft.iot.vmp.media.zlm.ZLMServerFactory; |
| | | import com.genersoft.iot.vmp.media.zlm.ZlmHttpHookSubscribe; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.OtherRtpSendInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import okhttp3.OkHttpClient; |
| | | import okhttp3.Request; |
| | |
| | | |
| | | @GetMapping(value = "/receive/open") |
| | | @ResponseBody |
| | | @Operation(summary = "开启收流和获取发流信息") |
| | | @Operation(summary = "开启收流和获取发流信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "isSend", description = "是否发送,false时只开启收流, true同时返回推流信息", required = true) |
| | | @Parameter(name = "callId", description = "整个过程的唯一标识,为了与后续接口关联", required = true) |
| | | @Parameter(name = "ssrc", description = "来源流的SSRC,不传则不校验来源ssrc", required = false) |
| | |
| | | |
| | | @GetMapping(value = "/receive/close") |
| | | @ResponseBody |
| | | @Operation(summary = "关闭收流") |
| | | @Operation(summary = "关闭收流", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "stream", description = "流的ID", required = true) |
| | | public void closeRtpServer(String stream) { |
| | | logger.info("[第三方服务对接->关闭收流] stream->{}", stream); |
| | |
| | | |
| | | @GetMapping(value = "/send/start") |
| | | @ResponseBody |
| | | @Operation(summary = "发送流") |
| | | @Operation(summary = "发送流", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "ssrc", description = "发送流的SSRC", required = true) |
| | | @Parameter(name = "dstIpForAudio", description = "目标音频收流IP", required = false) |
| | | @Parameter(name = "dstIpForVideo", description = "目标视频收流IP", required = false) |
| | |
| | | |
| | | @GetMapping(value = "/send/stop") |
| | | @ResponseBody |
| | | @Operation(summary = "关闭发送流") |
| | | @Operation(summary = "关闭发送流", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "callId", description = "整个过程的唯一标识,不传则使用随机端口发流", required = true) |
| | | public void closeSendRTP(String callId) { |
| | | logger.info("[第三方服务对接->关闭发送流] callId->{}", callId); |
| | |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.VersionInfo; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.media.zlm.SendRtpPortManager; |
| | | import com.genersoft.iot.vmp.media.zlm.ZlmHttpHookSubscribe; |
| | | import com.genersoft.iot.vmp.media.zlm.dto.IHookSubscribe; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.SystemConfigInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.springframework.beans.factory.annotation.Autowired; |
| | | import org.springframework.beans.factory.annotation.Value; |
| | |
| | | |
| | | @GetMapping(value = "/media_server/list") |
| | | @ResponseBody |
| | | @Operation(summary = "流媒体服务列表") |
| | | @Operation(summary = "流媒体服务列表", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public List<MediaServerItem> getMediaServerList() { |
| | | return mediaServerService.getAll(); |
| | | } |
| | | |
| | | @GetMapping(value = "/media_server/online/list") |
| | | @ResponseBody |
| | | @Operation(summary = "在线流媒体服务列表") |
| | | @Operation(summary = "在线流媒体服务列表", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public List<MediaServerItem> getOnlineMediaServerList() { |
| | | return mediaServerService.getAllOnline(); |
| | | } |
| | | |
| | | @GetMapping(value = "/media_server/one/{id}") |
| | | @ResponseBody |
| | | @Operation(summary = "停止视频回放") |
| | | @Operation(summary = "停止视频回放", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "id", description = "流媒体服务ID", required = true) |
| | | public MediaServerItem getMediaServer(@PathVariable String id) { |
| | | return mediaServerService.getOne(id); |
| | | } |
| | | |
| | | @Operation(summary = "测试流媒体服务") |
| | | @Operation(summary = "测试流媒体服务", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "ip", description = "流媒体服务IP", required = true) |
| | | @Parameter(name = "port", description = "流媒体服务HTT端口", required = true) |
| | | @Parameter(name = "secret", description = "流媒体服务secret", required = true) |
| | |
| | | return mediaServerService.checkMediaServer(ip, port, secret); |
| | | } |
| | | |
| | | @Operation(summary = "测试流媒体录像管理服务") |
| | | @Operation(summary = "测试流媒体录像管理服务", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "ip", description = "流媒体服务IP", required = true) |
| | | @Parameter(name = "port", description = "流媒体服务HTT端口", required = true) |
| | | @GetMapping(value = "/media_server/record/check") |
| | |
| | | } |
| | | } |
| | | |
| | | @Operation(summary = "保存流媒体服务") |
| | | @Operation(summary = "保存流媒体服务", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "mediaServerItem", description = "流媒体信息", required = true) |
| | | @PostMapping(value = "/media_server/save") |
| | | @ResponseBody |
| | |
| | | } |
| | | } |
| | | |
| | | @Operation(summary = "移除流媒体服务") |
| | | @Operation(summary = "移除流媒体服务", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "id", description = "流媒体ID", required = true) |
| | | @DeleteMapping(value = "/media_server/delete") |
| | | @ResponseBody |
| | |
| | | } |
| | | |
| | | |
| | | @Operation(summary = "重启服务") |
| | | @Operation(summary = "重启服务", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @GetMapping(value = "/restart") |
| | | @ResponseBody |
| | | public void restart() { |
| | |
| | | // }); |
| | | }; |
| | | |
| | | @Operation(summary = "获取系统信息信息") |
| | | @Operation(summary = "获取系统信息信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @GetMapping(value = "/system/configInfo") |
| | | @ResponseBody |
| | | public SystemConfigInfo getConfigInfo() { |
| | |
| | | return systemConfigInfo; |
| | | } |
| | | |
| | | @Operation(summary = "获取版本信息") |
| | | @Operation(summary = "获取版本信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @GetMapping(value = "/version") |
| | | @ResponseBody |
| | | public VersionPo VersionPogetVersion() { |
| | |
| | | import com.genersoft.iot.vmp.common.StreamInfo; |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.DeferredResultHolder; |
| | | import com.genersoft.iot.vmp.gb28181.transmit.callback.RequestMessage; |
| | | import com.genersoft.iot.vmp.media.zlm.dto.MediaServerItem; |
| | |
| | | import com.github.pagehelper.PageInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | private UserSetting userSetting; |
| | | |
| | | |
| | | @Operation(summary = "分页查询流代理") |
| | | @Operation(summary = "分页查询流代理", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page", description = "当前页") |
| | | @Parameter(name = "count", description = "每页查询数量") |
| | | @Parameter(name = "query", description = "查询内容") |
| | |
| | | return streamProxyService.getAll(page, count); |
| | | } |
| | | |
| | | @Operation(summary = "查询流代理") |
| | | @Operation(summary = "查询流代理", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名") |
| | | @Parameter(name = "stream", description = "流Id") |
| | | @GetMapping(value = "/one") |
| | |
| | | return streamProxyService.getStreamProxyByAppAndStream(app, stream); |
| | | } |
| | | |
| | | @Operation(summary = "保存代理", parameters = { |
| | | @Operation(summary = "保存代理", security = @SecurityRequirement(name = JwtUtils.HEADER), parameters = { |
| | | @Parameter(name = "param", description = "代理参数", required = true), |
| | | }) |
| | | @PostMapping(value = "/save") |
| | |
| | | |
| | | @GetMapping(value = "/ffmpeg_cmd/list") |
| | | @ResponseBody |
| | | @Operation(summary = "获取ffmpeg.cmd模板") |
| | | @Operation(summary = "获取ffmpeg.cmd模板", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "mediaServerId", description = "流媒体ID", required = true) |
| | | public JSONObject getFFmpegCMDs(@RequestParam String mediaServerId){ |
| | | logger.debug("获取节点[ {} ]ffmpeg.cmd模板", mediaServerId ); |
| | |
| | | |
| | | @DeleteMapping(value = "/del") |
| | | @ResponseBody |
| | | @Operation(summary = "移除代理") |
| | | @Operation(summary = "移除代理", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流id", required = true) |
| | | public void del(@RequestParam String app, @RequestParam String stream){ |
| | |
| | | |
| | | @GetMapping(value = "/start") |
| | | @ResponseBody |
| | | @Operation(summary = "启用代理") |
| | | @Operation(summary = "启用代理", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流id", required = true) |
| | | public void start(String app, String stream){ |
| | |
| | | |
| | | @GetMapping(value = "/stop") |
| | | @ResponseBody |
| | | @Operation(summary = "停用代理") |
| | | @Operation(summary = "停用代理", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流id", required = true) |
| | | public void stop(String app, String stream){ |
| | |
| | | import com.genersoft.iot.vmp.common.StreamInfo; |
| | | import com.genersoft.iot.vmp.conf.UserSetting; |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.conf.security.SecurityUtils; |
| | | import com.genersoft.iot.vmp.conf.security.dto.LoginUser; |
| | | import com.genersoft.iot.vmp.gb28181.bean.GbStream; |
| | |
| | | import com.github.pagehelper.PageInfo; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.slf4j.Logger; |
| | | import org.slf4j.LoggerFactory; |
| | |
| | | |
| | | @GetMapping(value = "/list") |
| | | @ResponseBody |
| | | @Operation(summary = "推流列表查询") |
| | | @Operation(summary = "推流列表查询", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page", description = "当前页") |
| | | @Parameter(name = "count", description = "每页查询数量") |
| | | @Parameter(name = "query", description = "查询内容") |
| | |
| | | |
| | | @PostMapping(value = "/save_to_gb") |
| | | @ResponseBody |
| | | @Operation(summary = "将推流添加到国标") |
| | | @Operation(summary = "将推流添加到国标", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public void saveToGB(@RequestBody GbStream stream){ |
| | | if (!streamPushService.saveToGB(stream)){ |
| | | throw new ControllerException(ErrorCode.ERROR100); |
| | |
| | | |
| | | @DeleteMapping(value = "/remove_form_gb") |
| | | @ResponseBody |
| | | @Operation(summary = "将推流移出到国标") |
| | | @Operation(summary = "将推流移出到国标", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public void removeFormGB(@RequestBody GbStream stream){ |
| | | if (!streamPushService.removeFromGB(stream)){ |
| | | throw new ControllerException(ErrorCode.ERROR100); |
| | |
| | | |
| | | @PostMapping(value = "/stop") |
| | | @ResponseBody |
| | | @Operation(summary = "中止一个推流") |
| | | @Operation(summary = "中止一个推流", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流id", required = true) |
| | | public void stop(String app, String streamId){ |
| | |
| | | |
| | | @DeleteMapping(value = "/batchStop") |
| | | @ResponseBody |
| | | @Operation(summary = "中止多个推流") |
| | | @Operation(summary = "中止多个推流", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public void batchStop(@RequestBody BatchGBStreamParam batchGBStreamParam){ |
| | | if (batchGBStreamParam.getGbStreams().size() == 0) { |
| | | throw new ControllerException(ErrorCode.ERROR100); |
| | |
| | | */ |
| | | @GetMapping(value = "/getPlayUrl") |
| | | @ResponseBody |
| | | @Operation(summary = "获取推流播放地址") |
| | | @Operation(summary = "获取推流播放地址", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "app", description = "应用名", required = true) |
| | | @Parameter(name = "stream", description = "流id", required = true) |
| | | @Parameter(name = "mediaServerId", description = "媒体服务器id") |
| | |
| | | */ |
| | | @PostMapping(value = "/add") |
| | | @ResponseBody |
| | | @Operation(summary = "添加推流信息") |
| | | @Operation(summary = "添加推流信息", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public void add(@RequestBody StreamPushItem stream){ |
| | | if (ObjectUtils.isEmpty(stream.getGbId())) { |
| | | throw new ControllerException(ErrorCode.ERROR400.getCode(), "国标ID不可为空"); |
| | |
| | | package com.genersoft.iot.vmp.vmanager.user; |
| | | |
| | | import com.genersoft.iot.vmp.conf.exception.ControllerException; |
| | | import com.genersoft.iot.vmp.conf.security.JwtUtils; |
| | | import com.genersoft.iot.vmp.conf.security.SecurityUtils; |
| | | import com.genersoft.iot.vmp.service.IRoleService; |
| | | import com.genersoft.iot.vmp.storager.dao.dto.Role; |
| | |
| | | import com.genersoft.iot.vmp.vmanager.bean.ErrorCode; |
| | | import io.swagger.v3.oas.annotations.Operation; |
| | | import io.swagger.v3.oas.annotations.Parameter; |
| | | import io.swagger.v3.oas.annotations.security.SecurityRequirement; |
| | | import io.swagger.v3.oas.annotations.tags.Tag; |
| | | import org.springframework.beans.factory.annotation.Autowired; |
| | | import org.springframework.web.bind.annotation.*; |
| | |
| | | private IRoleService roleService; |
| | | |
| | | @PostMapping("/add") |
| | | @Operation(summary = "添加角色") |
| | | @Operation(summary = "添加角色", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "name", description = "角色名", required = true) |
| | | @Parameter(name = "authority", description = "权限(自行定义内容,目前未使用)", required = true) |
| | | public void add(@RequestParam String name, |
| | |
| | | } |
| | | |
| | | @DeleteMapping("/delete") |
| | | @Operation(summary = "删除角色") |
| | | @Operation(summary = "删除角色", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "id", description = "用户Id", required = true) |
| | | public void delete(@RequestParam Integer id){ |
| | | // 获取当前登录用户id |
| | |
| | | } |
| | | |
| | | @GetMapping("/all") |
| | | @Operation(summary = "查询角色") |
| | | @Operation(summary = "查询角色", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public List<Role> all(){ |
| | | // 获取当前登录用户id |
| | | List<Role> allRoles = roleService.getAll(); |
| | |
| | | |
| | | |
| | | @PostMapping("/changePassword") |
| | | @Operation(summary = "修改密码") |
| | | @Operation(summary = "修改密码", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "username", description = "用户名", required = true) |
| | | @Parameter(name = "oldpassword", description = "旧密码(已md5加密的密码)", required = true) |
| | | @Parameter(name = "password", description = "新密码(未md5加密的密码)", required = true) |
| | |
| | | } |
| | | |
| | | @DeleteMapping("/delete") |
| | | @Operation(summary = "删除用户") |
| | | @Operation(summary = "删除用户", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "id", description = "用户Id", required = true) |
| | | public void delete(@RequestParam Integer id){ |
| | | // 获取当前登录用户id |
| | |
| | | } |
| | | |
| | | @GetMapping("/all") |
| | | @Operation(summary = "查询用户") |
| | | @Operation(summary = "查询用户", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | public List<User> all(){ |
| | | // 获取当前登录用户id |
| | | return userService.getAllUsers(); |
| | |
| | | * @return 分页用户列表 |
| | | */ |
| | | @GetMapping("/users") |
| | | @Operation(summary = "分页查询用户") |
| | | @Operation(summary = "分页查询用户", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "page", description = "当前页", required = true) |
| | | @Parameter(name = "count", description = "每页查询数量", required = true) |
| | | public PageInfo<User> users(int page, int count) { |
| | |
| | | } |
| | | |
| | | @RequestMapping("/changePushKey") |
| | | @Operation(summary = "修改pushkey") |
| | | @Operation(summary = "修改pushkey", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "userId", description = "用户Id", required = true) |
| | | @Parameter(name = "pushKey", description = "新的pushKey", required = true) |
| | | public void changePushKey(@RequestParam Integer userId,@RequestParam String pushKey) { |
| | |
| | | } |
| | | |
| | | @PostMapping("/changePasswordForAdmin") |
| | | @Operation(summary = "管理员修改普通用户密码") |
| | | @Operation(summary = "管理员修改普通用户密码", security = @SecurityRequirement(name = JwtUtils.HEADER)) |
| | | @Parameter(name = "adminId", description = "管理员id", required = true) |
| | | @Parameter(name = "userId", description = "用户id", required = true) |
| | | @Parameter(name = "password", description = "新密码(未md5加密的密码)", required = true) |