IvldClient (tencentcloud-sdk-java 3.1.1355 API)

java.lang.Object
- com.tencentcloudapi.common.AbstractClient
- - com.tencentcloudapi.ivld.v20210903.IvldClient

public class IvldClient
extends AbstractClient

Field Summary
- Fields inherited from class com.tencentcloudapi.common.AbstractClient
  gson, HTTP_RSP_OK, SDK_VERSION

Constructor Summary

Constructors
Constructor and Description
`IvldClient(Credential credential, String region)`
`IvldClient(Credential credential, String region, ClientProfile profile)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`AddCustomPersonImageResponse`	`AddCustomPersonImage(AddCustomPersonImageRequest req)` 增加自定义人脸图片，每个自定义人物最多可包含10张人脸图片请注意，与创建自定义人物一样，图片数据优先级优于图片URL优先级
`CreateCustomCategoryResponse`	`CreateCustomCategory(CreateCustomCategoryRequest req)` 创建自定义人物分类信息当L2Category为空时，将创建一级自定义分类。当L1Category与L2Category均不为空时，将创建二级自定义分类。请注意，只有当一级自定义分类存在时，才可创建二级自定义分类。
`CreateCustomGroupResponse`	`CreateCustomGroup(CreateCustomGroupRequest req)` 创建自定义人物库 Bucket的格式参考为 `bucketName-123456.cos.ap-shanghai.myqcloud.com` 在调用CreateCustomPerson和AddCustomPersonImage接口之前，请先确保本接口成功调用。当前每个用户只支持一个自定义人物库，一旦自定义人物库创建成功，后续接口调用均会返回人物库已存在错误。由于人脸图片对于自定义人物识别至关重要，因此自定义人物识别功能需要用户显式指定COS存储桶方可使用。具体来说，自定义人物识别功能接口(主要是CreateCustomPerson和AddCustomPersonImage)会在此COS桶下面新建IVLDCustomPersonImage目录，并在此目录下存储自定义人物图片数据以支持后续潜在的特征更新。请注意：本接口指定的COS桶仅用于备份存储自定义人物图片，CreateCustomPerson和AddCustomPersonImage接口入参URL可使用任意COS存储桶下的任意图片。重要**：请务必确保本接口指定的COS存储桶存在(不要手动删除COS桶)。COS存储桶一旦指定，将不能修改。
`CreateCustomPersonResponse`	`CreateCustomPerson(CreateCustomPersonRequest req)` 创建自定义人物。输入人物名称，基本信息，分类信息与人脸图片，创建自定义人物人脸图片可使用图片数据(base64编码的图片数据)或者图片URL(推荐使用COS以减少下载时间，其他地址也支持)，原始图片优先，也即如果同时指定了图片数据和图片URL，接口将仅使用图片数据
`CreateDefaultCategoriesResponse`	`CreateDefaultCategories(CreateDefaultCategoriesRequest req)` 创建默认自定义人物类型
`CreateTaskResponse`	`CreateTask(CreateTaskRequest req)` 创建智能标签任务。请注意，本接口为异步接口，返回TaskId只代表任务创建成功，不代表任务执行成功。
`CreateVideoSummaryTaskResponse`	`CreateVideoSummaryTask(CreateVideoSummaryTaskRequest req)` 创建一个视频缩编任务。 ### 回调事件消息通知协议 #### 网络协议 - 回调接口协议目前仅支持http/https协议； - 请求：HTTP POST 请求，包体内容为 JSON，每一种消息的具体包体内容参见后文。 - 应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容，为了协议友好，建议客户应答内容携带 JSON： `{"code":0}` #### 通知可靠性事件通知服务具备重试能力，事件通知失败后会总计重试3次；为了避免重试对您的服务器以及网络带宽造成冲击，请保持正常回包。触发重试条件如下： - 长时间（5 秒）未回包应答。 - 应答 HTTP STATUS 不为200。 #### 回调接口协议 ##### 分析任务完成消息回调 \| 参数名称 \| 必选 \| 类型 \| 描述 \| \|---------\|---------\|---------\|---------\| \| TaskId \| 是 \| String \| 任务ID \| \| TaskStatus \| 是 \| Integer \| 任务执行状态 \| \| FailedReason \| 是 \| String \| 若任务失败，该字段为失败原因 \|
`DeleteCustomCategoryResponse`	`DeleteCustomCategory(DeleteCustomCategoryRequest req)` 删除自定义分类信息
`DeleteCustomPersonResponse`	`DeleteCustomPerson(DeleteCustomPersonRequest req)` 删除自定义人物
`DeleteCustomPersonImageResponse`	`DeleteCustomPersonImage(DeleteCustomPersonImageRequest req)` 删除自定义人脸数据
`DeleteMediaResponse`	`DeleteMedia(DeleteMediaRequest req)` 将MediaId对应的媒资文件从系统中删除。请注意，本接口仅删除媒资文件，媒资文件对应的视频分析结果不会被删除**。如您需要删除结构化分析结果，请调用DeleteTask接口。
`DeleteTaskResponse`	`DeleteTask(DeleteTaskRequest req)` 删除任务信息请注意，本接口不会删除媒资文件只有已完成(成功或者失败)的任务可以删除，正在执行中的任务不支持删除
`DescribeCustomCategoriesResponse`	`DescribeCustomCategories(DescribeCustomCategoriesRequest req)` 批量描述自定义人物分类信息
`DescribeCustomGroupResponse`	`DescribeCustomGroup(DescribeCustomGroupRequest req)` 描述自定义人物库信息，当前库大小(库中有多少人脸)，以及库中的存储桶
`DescribeCustomPersonDetailResponse`	`DescribeCustomPersonDetail(DescribeCustomPersonDetailRequest req)` 描述自定义人物详细信息，包括人物信息与人物信息
`DescribeCustomPersonsResponse`	`DescribeCustomPersons(DescribeCustomPersonsRequest req)` 批量描述自定义人物
`DescribeMediaResponse`	`DescribeMedia(DescribeMediaRequest req)` 描述媒资文件信息，包括媒资状态，分辨率，帧率等。如果媒资文件未完成导入，本接口将仅输出媒资文件的状态信息；导入完成后，本接口还将输出媒资文件的其他元信息。
`DescribeMediasResponse`	`DescribeMedias(DescribeMediasRequest req)` 依照输入条件，描述命中的媒资文件信息，包括媒资状态，分辨率，帧率等。请注意，本接口最多支持同时描述50个媒资文件如果媒资文件未完成导入，本接口将仅输出媒资文件的状态信息；导入完成后，本接口还将输出媒资文件的其他元信息。
`DescribeTaskResponse`	`DescribeTask(DescribeTaskRequest req)` 描述智能标签任务进度。请注意，此接口仅返回任务执行状态信息，不返回任务执行结果
`DescribeTaskDetailResponse`	`DescribeTaskDetail(DescribeTaskDetailRequest req)` 描述任务信息，如果任务成功完成，还将返回任务结果
`DescribeTasksResponse`	`DescribeTasks(DescribeTasksRequest req)` 依照输入条件，描述命中的任务信息，包括任务创建时间，处理时间信息等。请注意，本接口最多支持同时描述50个任务信息
`DescribeUsageAmountResponse`	`DescribeUsageAmount(DescribeUsageAmountRequest req)` 获取用户资源使用量
`DescribeVideoSummaryDetailResponse`	`DescribeVideoSummaryDetail(DescribeVideoSummaryDetailRequest req)` 描述任务信息，如果任务成功完成，还将返回任务结果
`ImportMediaResponse`	`ImportMedia(ImportMediaRequest req)` 将URL指向的媒资视频文件导入系统之中。请注意，本接口为异步接口**。接口返回MediaId仅代表导入视频任务发起，不代表任务完成，您可调用读接口(DescribeMedia/DescribeMedias)接口查询MediaId URL字段推荐您使用COS地址，其形式为`https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}`，其中`${Bucket}`为您的COS桶名称，Region为COS桶所在[可用区](https://cloud.tencent.com/document/product/213/6091)，`${ObjectKey}`为指向存储在COS桶内的待分析的视频的[ObjectKey](https://cloud.tencent.com/document/product/436/13324) 另外，目前产品也支持使用外部URL地址，但是当传入URL为非COS地址时，需要您指定额外的WriteBackCosPath以供产品回写结果数据。分析完成后，本产品将在您的`${Bucket}`桶内创建名为`${ObjectKey}_${task-create-time}`的目录(`task-create-time`形式为1970-01-01T08:08:08)并将分析结果将回传回该目录，也即，结构化分析结果(包括图片，JSON等数据)将会写回`https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}_${task-create-time}`目录
`ModifyCallbackResponse`	`ModifyCallback(ModifyCallbackRequest req)` 用户设置对应事件的回调地址 ### 回调事件消息通知协议 #### 网络协议 - 回调接口协议目前仅支持http/https协议； - 请求：HTTP POST 请求，包体内容为 JSON，每一种消息的具体包体内容参见后文。 - 应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容，为了协议友好，建议客户应答内容携带 JSON： `{"code":0}` #### 通知可靠性事件通知服务具备重试能力，事件通知失败后会总计重试3次；为了避免重试对您的服务器以及网络带宽造成冲击，请保持正常回包。触发重试条件如下： - 长时间（5 秒）未回包应答。 - 应答 HTTP STATUS 不为200。 #### 回调接口协议 ##### 分析任务完成消息回调 \| 参数名称 \| 必选 \| 类型 \| 描述 \| \|---------\|---------\|---------\|---------\| \| EventType \| 是 \| int \| 回调时间类型，1-任务分析完成，2-媒资导入完成 \| \| TaskId \| 是 \| String \| 任务ID \| \| TaskStatus \| 是 \| [TaskStatus](/document/product/1509/65063#TaskInfo) \| 任务执行状态 \| \| FailedReason \| 是 \| String \| 若任务失败，该字段为失败原因 \| ##### 导入媒资完成消息回调 \| 参数名称 \| 必选 \| 类型 \| 描述 \| \|---------\|---------\|---------\|---------\| \| EventType \| 是 \| int \| 回调时间类型，1-任务分析完成，2-媒资导入完成 \| \| MediaId \| 是 \| String \| 媒资ID \| \| MediaStatus \| 是 \| [MediaStatus](/document/product/1509/65063#MediaInfo) \| 媒资导入状态\| \| FailedReason \| 是 \| String \| 若任务失败，该字段为失败原因 \|
`QueryCallbackResponse`	`QueryCallback(QueryCallbackRequest req)` 查询用户回调设置
`UpdateCustomCategoryResponse`	`UpdateCustomCategory(UpdateCustomCategoryRequest req)` 更新自定义人物分类当L2Category为空时，代表更新CategoryId对应的一级自定义人物类型以及所有二级自定义人物类型所从属的一级自定义人物类型；当L2Category非空时，仅更新CategoryId对应的二级自定义人物类型
`UpdateCustomPersonResponse`	`UpdateCustomPerson(UpdateCustomPersonRequest req)` 更新自定义人物信息，包括姓名，简要信息，分类信息等

Methods inherited from class com.tencentcloudapi.common.AbstractClient
call, callOctetStream, getClientProfile, getCredential, getRegion, getRegionBreaker, internalRequest, internalRequest, internalRequestRaw, processResponseJson, processResponseSSE, retry, setClientProfile, setCredential, setRegion, setRegionBreaker

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - IvldClient
```
public IvldClient(Credential credential,
                  String region)
```
  - IvldClient
```
public IvldClient(Credential credential,
                  String region,
                  ClientProfile profile)
```
- Method Detail
  - AddCustomPersonImage
```
public AddCustomPersonImageResponse AddCustomPersonImage(AddCustomPersonImageRequest req)
                                                  throws TencentCloudSDKException
```
    增加自定义人脸图片，每个自定义人物最多可包含10张人脸图片请注意，与创建自定义人物一样，图片数据优先级优于图片URL优先级
    
    Parameters:
    
    req - AddCustomPersonImageRequest
    
    Returns:
    
    AddCustomPersonImageResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateCustomCategory
```
public CreateCustomCategoryResponse CreateCustomCategory(CreateCustomCategoryRequest req)
                                                  throws TencentCloudSDKException
```
    创建自定义人物分类信息当L2Category为空时，将创建一级自定义分类。当L1Category与L2Category均不为空时，将创建二级自定义分类。请注意，**只有当一级自定义分类存在时，才可创建二级自定义分类**。
    
    Parameters:
    
    req - CreateCustomCategoryRequest
    
    Returns:
    
    CreateCustomCategoryResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateCustomGroup
```
public CreateCustomGroupResponse CreateCustomGroup(CreateCustomGroupRequest req)
                                            throws TencentCloudSDKException
```
    创建自定义人物库 Bucket的格式参考为 `bucketName-123456.cos.ap-shanghai.myqcloud.com` 在调用CreateCustomPerson和AddCustomPersonImage接口之前，请先确保本接口成功调用。当前每个用户只支持一个自定义人物库，一旦自定义人物库创建成功，后续接口调用均会返回人物库已存在错误。由于人脸图片对于自定义人物识别至关重要，因此自定义人物识别功能需要用户显式指定COS存储桶方可使用。具体来说，自定义人物识别功能接口(主要是CreateCustomPerson和AddCustomPersonImage)会在此COS桶下面新建IVLDCustomPersonImage目录，并在此目录下存储自定义人物图片数据以支持后续潜在的特征更新。请注意：本接口指定的COS桶仅用于**备份存储自定义人物图片**，CreateCustomPerson和AddCustomPersonImage接口入参URL可使用任意COS存储桶下的任意图片。重要**：请务必确保本接口指定的COS存储桶存在(不要手动删除COS桶)。COS存储桶一旦指定，将不能修改。
    
    Parameters:
    
    req - CreateCustomGroupRequest
    
    Returns:
    
    CreateCustomGroupResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateCustomPerson
```
public CreateCustomPersonResponse CreateCustomPerson(CreateCustomPersonRequest req)
                                              throws TencentCloudSDKException
```
    创建自定义人物。输入人物名称，基本信息，分类信息与人脸图片，创建自定义人物人脸图片可使用图片数据(base64编码的图片数据)或者图片URL(推荐使用COS以减少下载时间，其他地址也支持)，原始图片优先，也即如果同时指定了图片数据和图片URL，接口将仅使用图片数据
    
    Parameters:
    
    req - CreateCustomPersonRequest
    
    Returns:
    
    CreateCustomPersonResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateDefaultCategories
```
public CreateDefaultCategoriesResponse CreateDefaultCategories(CreateDefaultCategoriesRequest req)
                                                        throws TencentCloudSDKException
```
    创建默认自定义人物类型
    
    Parameters:
    
    req - CreateDefaultCategoriesRequest
    
    Returns:
    
    CreateDefaultCategoriesResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateTask
```
public CreateTaskResponse CreateTask(CreateTaskRequest req)
                              throws TencentCloudSDKException
```
    创建智能标签任务。请注意，本接口为异步接口，**返回TaskId只代表任务创建成功，不代表任务执行成功**。
    
    Parameters:
    
    req - CreateTaskRequest
    
    Returns:
    
    CreateTaskResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateVideoSummaryTask
```
public CreateVideoSummaryTaskResponse CreateVideoSummaryTask(CreateVideoSummaryTaskRequest req)
                                                      throws TencentCloudSDKException
```
    创建一个视频缩编任务。 ### 回调事件消息通知协议 #### 网络协议 - 回调接口协议目前仅支持http/https协议； - 请求：HTTP POST 请求，包体内容为 JSON，每一种消息的具体包体内容参见后文。 - 应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容，为了协议友好，建议客户应答内容携带 JSON： `{"code":0}` #### 通知可靠性事件通知服务具备重试能力，事件通知失败后会总计重试3次；为了避免重试对您的服务器以及网络带宽造成冲击，请保持正常回包。触发重试条件如下： - 长时间（5 秒）未回包应答。 - 应答 HTTP STATUS 不为200。 #### 回调接口协议 ##### 分析任务完成消息回调 | 参数名称 | 必选 | 类型 | 描述 | |---------|---------|---------|---------| | TaskId | 是 | String | 任务ID | | TaskStatus | 是 | Integer | 任务执行状态 | | FailedReason | 是 | String | 若任务失败，该字段为失败原因 |
    
    Parameters:
    
    req - CreateVideoSummaryTaskRequest
    
    Returns:
    
    CreateVideoSummaryTaskResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteCustomCategory
```
public DeleteCustomCategoryResponse DeleteCustomCategory(DeleteCustomCategoryRequest req)
                                                  throws TencentCloudSDKException
```
    删除自定义分类信息
    
    Parameters:
    
    req - DeleteCustomCategoryRequest
    
    Returns:
    
    DeleteCustomCategoryResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteCustomPerson
```
public DeleteCustomPersonResponse DeleteCustomPerson(DeleteCustomPersonRequest req)
                                              throws TencentCloudSDKException
```
    删除自定义人物
    
    Parameters:
    
    req - DeleteCustomPersonRequest
    
    Returns:
    
    DeleteCustomPersonResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteCustomPersonImage
```
public DeleteCustomPersonImageResponse DeleteCustomPersonImage(DeleteCustomPersonImageRequest req)
                                                        throws TencentCloudSDKException
```
    删除自定义人脸数据
    
    Parameters:
    
    req - DeleteCustomPersonImageRequest
    
    Returns:
    
    DeleteCustomPersonImageResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteMedia
```
public DeleteMediaResponse DeleteMedia(DeleteMediaRequest req)
                                throws TencentCloudSDKException
```
    将MediaId对应的媒资文件从系统中删除。请注意，本接口仅删除媒资文件，媒资文件对应的视频分析结果不会被删除**。如您需要删除结构化分析结果，请调用DeleteTask接口。
    
    Parameters:
    
    req - DeleteMediaRequest
    
    Returns:
    
    DeleteMediaResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteTask
```
public DeleteTaskResponse DeleteTask(DeleteTaskRequest req)
                              throws TencentCloudSDKException
```
    删除任务信息请注意，本接口**不会**删除媒资文件只有已完成(成功或者失败)的任务可以删除，**正在执行中的任务不支持删除**
    
    Parameters:
    
    req - DeleteTaskRequest
    
    Returns:
    
    DeleteTaskResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeCustomCategories
```
public DescribeCustomCategoriesResponse DescribeCustomCategories(DescribeCustomCategoriesRequest req)
                                                          throws TencentCloudSDKException
```
    批量描述自定义人物分类信息
    
    Parameters:
    
    req - DescribeCustomCategoriesRequest
    
    Returns:
    
    DescribeCustomCategoriesResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeCustomGroup
```
public DescribeCustomGroupResponse DescribeCustomGroup(DescribeCustomGroupRequest req)
                                                throws TencentCloudSDKException
```
    描述自定义人物库信息，当前库大小(库中有多少人脸)，以及库中的存储桶
    
    Parameters:
    
    req - DescribeCustomGroupRequest
    
    Returns:
    
    DescribeCustomGroupResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeCustomPersonDetail
```
public DescribeCustomPersonDetailResponse DescribeCustomPersonDetail(DescribeCustomPersonDetailRequest req)
                                                              throws TencentCloudSDKException
```
    描述自定义人物详细信息，包括人物信息与人物信息
    
    Parameters:
    
    req - DescribeCustomPersonDetailRequest
    
    Returns:
    
    DescribeCustomPersonDetailResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeCustomPersons
```
public DescribeCustomPersonsResponse DescribeCustomPersons(DescribeCustomPersonsRequest req)
                                                    throws TencentCloudSDKException
```
    批量描述自定义人物
    
    Parameters:
    
    req - DescribeCustomPersonsRequest
    
    Returns:
    
    DescribeCustomPersonsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeMedia
```
public DescribeMediaResponse DescribeMedia(DescribeMediaRequest req)
                                    throws TencentCloudSDKException
```
    描述媒资文件信息，包括媒资状态，分辨率，帧率等。如果媒资文件未完成导入，本接口将仅输出媒资文件的状态信息；导入完成后，本接口还将输出媒资文件的其他元信息。
    
    Parameters:
    
    req - DescribeMediaRequest
    
    Returns:
    
    DescribeMediaResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeMedias
```
public DescribeMediasResponse DescribeMedias(DescribeMediasRequest req)
                                      throws TencentCloudSDKException
```
    依照输入条件，描述命中的媒资文件信息，包括媒资状态，分辨率，帧率等。请注意，本接口最多支持同时描述**50**个媒资文件如果媒资文件未完成导入，本接口将仅输出媒资文件的状态信息；导入完成后，本接口还将输出媒资文件的其他元信息。
    
    Parameters:
    
    req - DescribeMediasRequest
    
    Returns:
    
    DescribeMediasResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeTask
```
public DescribeTaskResponse DescribeTask(DescribeTaskRequest req)
                                  throws TencentCloudSDKException
```
    描述智能标签任务进度。请注意，**此接口仅返回任务执行状态信息，不返回任务执行结果**
    
    Parameters:
    
    req - DescribeTaskRequest
    
    Returns:
    
    DescribeTaskResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeTaskDetail
```
public DescribeTaskDetailResponse DescribeTaskDetail(DescribeTaskDetailRequest req)
                                              throws TencentCloudSDKException
```
    描述任务信息，如果任务成功完成，还将返回任务结果
    
    Parameters:
    
    req - DescribeTaskDetailRequest
    
    Returns:
    
    DescribeTaskDetailResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeTasks
```
public DescribeTasksResponse DescribeTasks(DescribeTasksRequest req)
                                    throws TencentCloudSDKException
```
    依照输入条件，描述命中的任务信息，包括任务创建时间，处理时间信息等。请注意，本接口最多支持同时描述**50**个任务信息
    
    Parameters:
    
    req - DescribeTasksRequest
    
    Returns:
    
    DescribeTasksResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeUsageAmount
```
public DescribeUsageAmountResponse DescribeUsageAmount(DescribeUsageAmountRequest req)
                                                throws TencentCloudSDKException
```
    获取用户资源使用量
    
    Parameters:
    
    req - DescribeUsageAmountRequest
    
    Returns:
    
    DescribeUsageAmountResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeVideoSummaryDetail
```
public DescribeVideoSummaryDetailResponse DescribeVideoSummaryDetail(DescribeVideoSummaryDetailRequest req)
                                                              throws TencentCloudSDKException
```
    描述任务信息，如果任务成功完成，还将返回任务结果
    
    Parameters:
    
    req - DescribeVideoSummaryDetailRequest
    
    Returns:
    
    DescribeVideoSummaryDetailResponse
    
    Throws:
    
    TencentCloudSDKException
  - ImportMedia
```
public ImportMediaResponse ImportMedia(ImportMediaRequest req)
                                throws TencentCloudSDKException
```
    将URL指向的媒资视频文件导入系统之中。请注意，本接口为异步接口**。接口返回MediaId仅代表导入视频任务发起，不代表任务完成，您可调用读接口(DescribeMedia/DescribeMedias)接口查询MediaId URL字段推荐您使用COS地址，其形式为`https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}`，其中`${Bucket}`为您的COS桶名称，Region为COS桶所在[可用区](https://cloud.tencent.com/document/product/213/6091)，`${ObjectKey}`为指向存储在COS桶内的待分析的视频的[ObjectKey](https://cloud.tencent.com/document/product/436/13324) 另外，目前产品也支持使用外部URL地址，但是当传入URL为非COS地址时，需要您指定额外的WriteBackCosPath以供产品回写结果数据。分析完成后，本产品将在您的`${Bucket}`桶内创建名为`${ObjectKey}_${task-create-time}`的目录(`task-create-time`形式为1970-01-01T08:08:08)并将分析结果将回传回该目录，也即，结构化分析结果(包括图片，JSON等数据)将会写回`https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}_${task-create-time}`目录
    
    Parameters:
    
    req - ImportMediaRequest
    
    Returns:
    
    ImportMediaResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyCallback
```
public ModifyCallbackResponse ModifyCallback(ModifyCallbackRequest req)
                                      throws TencentCloudSDKException
```
    用户设置对应事件的回调地址 ### 回调事件消息通知协议 #### 网络协议 - 回调接口协议目前仅支持http/https协议； - 请求：HTTP POST 请求，包体内容为 JSON，每一种消息的具体包体内容参见后文。 - 应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容，为了协议友好，建议客户应答内容携带 JSON： `{"code":0}` #### 通知可靠性事件通知服务具备重试能力，事件通知失败后会总计重试3次；为了避免重试对您的服务器以及网络带宽造成冲击，请保持正常回包。触发重试条件如下： - 长时间（5 秒）未回包应答。 - 应答 HTTP STATUS 不为200。 #### 回调接口协议 ##### 分析任务完成消息回调 | 参数名称 | 必选 | 类型 | 描述 | |---------|---------|---------|---------| | EventType | 是 | int | 回调时间类型，1-任务分析完成，2-媒资导入完成 | | TaskId | 是 | String | 任务ID | | TaskStatus | 是 | [TaskStatus](/document/product/1509/65063#TaskInfo) | 任务执行状态 | | FailedReason | 是 | String | 若任务失败，该字段为失败原因 | ##### 导入媒资完成消息回调 | 参数名称 | 必选 | 类型 | 描述 | |---------|---------|---------|---------| | EventType | 是 | int | 回调时间类型，1-任务分析完成，2-媒资导入完成 | | MediaId | 是 | String | 媒资ID | | MediaStatus | 是 | [MediaStatus](/document/product/1509/65063#MediaInfo) | 媒资导入状态| | FailedReason | 是 | String | 若任务失败，该字段为失败原因 |
    
    Parameters:
    
    req - ModifyCallbackRequest
    
    Returns:
    
    ModifyCallbackResponse
    
    Throws:
    
    TencentCloudSDKException
  - QueryCallback
```
public QueryCallbackResponse QueryCallback(QueryCallbackRequest req)
                                    throws TencentCloudSDKException
```
    查询用户回调设置
    
    Parameters:
    
    req - QueryCallbackRequest
    
    Returns:
    
    QueryCallbackResponse
    
    Throws:
    
    TencentCloudSDKException
  - UpdateCustomCategory
```
public UpdateCustomCategoryResponse UpdateCustomCategory(UpdateCustomCategoryRequest req)
                                                  throws TencentCloudSDKException
```
    更新自定义人物分类当L2Category为空时，代表更新CategoryId对应的一级自定义人物类型以及所有二级自定义人物类型所从属的一级自定义人物类型；当L2Category非空时，仅更新CategoryId对应的二级自定义人物类型
    
    Parameters:
    
    req - UpdateCustomCategoryRequest
    
    Returns:
    
    UpdateCustomCategoryResponse
    
    Throws:
    
    TencentCloudSDKException
  - UpdateCustomPerson
```
public UpdateCustomPersonResponse UpdateCustomPerson(UpdateCustomPersonRequest req)
                                              throws TencentCloudSDKException
```
    更新自定义人物信息，包括姓名，简要信息，分类信息等
    
    Parameters:
    
    req - UpdateCustomPersonRequest
    
    Returns:
    
    UpdateCustomPersonResponse
    
    Throws:
    
    TencentCloudSDKException

Class IvldClient

Field Summary

Fields inherited from class com.tencentcloudapi.common.AbstractClient

Constructor Summary

Method Summary

Methods inherited from class com.tencentcloudapi.common.AbstractClient

Methods inherited from class java.lang.Object

Constructor Detail

IvldClient

IvldClient

Method Detail

AddCustomPersonImage

CreateCustomCategory

CreateCustomGroup

CreateCustomPerson

CreateDefaultCategories

CreateTask

CreateVideoSummaryTask

DeleteCustomCategory

DeleteCustomPerson

DeleteCustomPersonImage

DeleteMedia

DeleteTask

DescribeCustomCategories

DescribeCustomGroup

DescribeCustomPersonDetail

DescribeCustomPersons

DescribeMedia

DescribeMedias

DescribeTask

DescribeTaskDetail

DescribeTasks

DescribeUsageAmount

DescribeVideoSummaryDetail

ImportMedia

ModifyCallback

QueryCallback

UpdateCustomCategory

UpdateCustomPerson