创建空间
更新时间：2022-11-11
创建空间
功能描述
用于创建EVS空间
示例代码
SpaceCreateRequest request = new SpaceCreateRequest();
request.setSpaceName("test_sdk");
request.setEdgeId(1L);
...
SpaceCreateResponse response = evsClient.createSpace(request);请求参数
通过SpaceCreateRequest对象设置请求参数，要求如下：
| 属性名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| spaceName | String | 是 | 空间名称，最大长度64个字符 |
| description | String | 否 | 空间描述，最大长度512个字符 |
| type | String | 否 | 空间类型，默认RTMP，可选值：RTMP/GB28181/BVCP |
| deviceMode | String | 否 | 设备型号，bvcp空间需要 |
| domains | Array | 否 | 空间自定义域名 |
| + domain | String | 是 | 自定义域名 |
| + type | String | 是 | 域名类型，推流：UPSTREAM，播放：DOWNSTREAM；GB28181空间无推流域名 |
| upstreamAuth | Object | 否 | 推流鉴权；GB28181空间无推流鉴权 |
| + enabled | Boolean | 是 | 是否开启推流鉴权 |
| + key | String | 否 | 鉴权key |
| + expire | Integer | 否 | 鉴权过期时间，单位：秒 |
| downstreamAuth | Object | 否 | 播放鉴权 |
| + enabled | Boolean | 是 | 是否开启播放鉴权 |
| + key | String | 否 | 鉴权key |
| + expire | Integer | 否 | 鉴权过期时间，单位：秒 |
| recording | Object | 否 | 录制配置 |
| + enabled | Boolean | 是 | 是否开启录制 |
| + duration | Integer | 否 | 录制单文件时长，单位：秒 |
| + format | String | 否 | 存储格式，可选：MP4、FLV、M3U8 |
| + authEnabled | Boolean | 是 | 录制文件下载地址是否开启鉴权 |
| + authExpire | Integer | 否 | 鉴权URL有效时间，单位：秒 |
| thumbnail | Object | 否 | 截图配置 |
| + enabled | Boolean | 是 | 是否开启截图 |
| + bucket | String | 否 | 边缘存储bucket |
| + interval | Integer | 否 | 截图周期，单位：秒 |
| + authEnabled | Boolean | 是 | 截图文件下载地址是否开启鉴权 |
| + authExpire | Integer | 否 | 鉴权URL有效时间，单位：秒 |
| timeShift | Object | 否 | 时移配置 |
| + enabled | Boolean | 是 | 是否开启时移 |
| + range | Integer | 是 | 时移范围，单位：秒 |
| callback | Object | 否 | 通知配置 |
| + enabled | Boolean | 是 | 是否开启通知 |
| + types | Array | 是 | 回调类型列表，支持多个，开启时必填；推流回调：ON_PUBLISH，断流回调：ON_UNPUBLISH，截图回调：ON_SNAPSHOT，录像回调：ON_RECORD，播放回调：ON_PLAY，停播回调：ON_STOP，在线回调：ON_REGISTER，离线回调：ON_UNREGISTER，AI算子回调：ON_BASE_AI |
| + endpoint | String | 是 | 回调地址，开启时必填；支持http/https，https需用户自己检测域名证书链配置是否正确 |
| + authEnabled | Boolean | 否 | 回调是否验证签名，默认不验证false |
| + key | String | 否 | 回调签名key，用于计算token |
| gbProperties | Object | 否 | 国标配置 |
| + inviteImmediate | Boolean | 是 | 立即拉流，默认是。否：只有播放时触发拉流；是：注册后立即拉流 |
| aiConfig | Object | 否 | AI分析配置 |
| + enabled | Boolean | 是 | 是否开启AI分析 |
| + configuration | Array | 否 | AI配置列表 |
| ++ type | String | 是 | AI检测类型，FACE：人脸, BODY：人体, ELECTRIC：电动车, ELECTRIC_ELEVATOR：电车入梯,CAR_ATTRIBUTE：车辆属性, CAR_MODEL：车型, CAR_PLATE：车牌，STATIC_HUMAN_TRAFFIC：静态人流量，STATIC_CAR_TRAFFIC：静态车流量, QUALITY_BRIGHT：视频质量亮度检测, QUALITY_COLOR：视频质量偏色检测, QUALITY_COVER：视频质量遮挡检测, QUALITY_BLUR：视频质量模糊检测, QUALITY_NOISE：视频质量噪声检测 |
| ++ interval | Integer | 是 | AI截图间隔 |
| ++ strategy | String | 是 | AI分析结果入库策略，OPTIMAL：最优, FASTEST：最快, REGULAR：定时 |
| ++ effectiveTimes | Array | 否 | 检测生效时段，支持多个；输入东八区时间，从00:00:00开始，到23:59:59结束，每段间隔最小半小时 |
| +++ effectiveTimeStart | String | 是 | 检测生效开始时间，格式"HH:mm:ss" |
| +++ effectiveTimeEnd | String | 是 | 检测生效结束时间，格式"HH:mm:ss" |
| + ftpConfig | Object | 否 | Ftp图片流设置 |
| ++ enabled | Boolean | 是 | 是否开启Ftp图片流 |
| ++ password | String | 是 | ftp登录password，长度8-32位，支持字符a-zA-Z0-9-_^* |
| edgeId | Long | 是 | 空间对应的边缘ID |
响应内容
创建后的响应数据封装在SpaceCreateResponse对象中，包含如下：
| 属性名称 | 类型 | 描述 |
|---|---|---|
| spaceId | Long | 空间ID |
| domains | Array | 空间自定义域名 |
| + domain | String | 自定义域名/系统创建域名 |
| + type | String | 域名类型，推流：UPSTREAM，播放：DOWNSTREAM |
| + cname | String | 域名cname |