This topic describes the data types related to media fingerprint analysis.

AliyunOSSFile

Description

The details of the Object Storage Service (OSS) object that is used as the job input.

ParameterTypeDescription
BucketStringThe name of the OSS bucket in which the OSS object is stored. The value must be 3 to 63 bytes in length.
LocationStringThe name of the OSS region in which the OSS object resides. The value can be up to 64 bytes in length.
ObjectStringThe name of the OSS object. The value can be up to 1,024 bytes in length.

AliyunFpShotJob

Description

The details of the media fingerprint analysis job.

ParameterTypeDescription
IdStringThe ID of the job.
InputFileAliyunOSSFileThe information about the job input.
FpShotConfigAliyunFpShotConfigThe configurations of the job.
PipelineIdStringThe ID of the ApsaraVideo Media Processing (MPS) queue.
StateStringThe status of the job. Valid values:
  • Queuing: The job is waiting in the queue.
  • Analysing: The job is in progress.
  • Success: The job is successful.
  • Fail: The job fails.
CodeStringThe error code returned when the job fails.
MessageStringThe error message returned when the job fails.
UserDataStringThe custom data.
FpShotResultFpShotResultThe media fingerprint analysis results.

FpShotConfig

The configurations of the media fingerprint analysis job.

ParameterTypeRequiredDescription
PrimaryKeyStringYesThe unique primary key of the input video.
SaveTypeStringYesThe storage type. Valid values: nosave and save.
FpDBIdStringYesThe ID of the media fingerprint library involved in a query operation.
TextTypeStringYesThe text type. This parameter is valid only for text fingerprint analysis. A value of Text indicates a long text string. A value of ASR indicates speech recognition text.

FpShotResult

The media fingerprint analysis results.

ParameterTypeDescription
FpShotsFpShot[]The video fingerprint analysis results.
TextFpShotsTextFpShots[]The text fingerprint analysis results.

FpShot

Description

The details of the video fingerprint analysis results.

ParameterTypeDescription
PrimaryKeyStringThe unique primary key of the input video.
SimilarityStringThe similarity of the input video against videos that have similar fingerprints to the input video in the media fingerprint library.
FpShotSlicesFpShotSlice[]The array of videos that have similar fingerprints to the input video in the media fingerprint library. If a video clip in the input video has similar fingerprints to a video clip in a video in the media fingerprint library, the start point in time and length of the similar video clip in the input video and similar video are returned.

FpShotSlice

Description

The details of the similar video clip.

ParameterTypeDescription
InputStringThe start point in time and length of the similar video clip in the input video.
DuplicationStringThe start point in time and length of the similar video clip in the video that has similar fingerprints to the input video in the media fingerprint library.

TextFpShotSlice

The details of the text fingerprint analysis results.

ParameterTypeExampleDescription
PrimaryKeyStringf3bd5404The unique primary key of the input video.
SimilarityString1.0The similarity of the input text against text snippets that have similar fingerprints to the input text in the text fingerprint library.
TextFpShotSlicesTextFpShotSlice[] -The array of text snippets that have similar fingerprints to the input text in the text fingerprint library.
TextFpShotSlices

The details of the similar text snippet.

ParameterTypeExampleDescription
InputFragmentInputFragment-The start point in time and length of the similar text snippet in the input text.
InputTextStringLi Xiangqian sits down in silence and puts his arms on the dirty table. Two dishes and two liang liquor, as usual. These are delicacies this mom-and-pop stall can provide. The speech recognition results of the input text for text fingerprint analysis.
DuplicationTextStringIt seems that he is a regular guest of this stall. The stall owner does not ask what he wants to order, but turns backward and shouts, "Scrambled eggs! Pig ear salad! Two liang liquor!" Li Xiangqian sits down in silence and puts his arms on the dirty table...The text snippet that has similar fingerprints to the input text in the text fingerprint library.
SimilarityString1.0The similarity of the input text against the text snippet that has similar fingerprints to the input text in the text fingerprint library.
InputFragment
ParameterTypeDescription
StartStringThe start point in time.
DurationString The length.

AliyunFpShotJobNotify

Description

The notification of the results of the media fingerprint analysis job.

ParameterTypeDescription
TypeStringThe type of the notification.
UserDataStromgThe custom data that you specified when you submit the job. This parameter is returned in the response.
JobIdStringThe ID of the job.
StateStringThe results of the job. Valid values:
  • Success: The job is successful.
  • Fail: The job fails.
CodeStringThe error code returned when the job fails.
MessageStringThe error message returned when the job fails.
FpShotsFpShot[]The details of the media fingerprint analysis results.

FpResultLogInfo

Description

The logs that record the results of importing text files to the text fingerprint library.

ParameterTypeDescription
LogPathStringThe path for downloading the log.
LogNameStringThe name of the log file.
LogStartTimeLongThe start point in time of the log.
LogEndTimeLongThe end point in time of the log.
LogSizeLongThe size of the log file.

Unit: byte.

CreateTimeLongThe point in time when the log was generated.

PageInfo

Description

The paging information about the query results.

ParameterTypeDescription
PageIndexLongThe number of the returned page.
PageSizeLongThe number of entries returned on each page.
TotalLongThe total number of log files that are queried.

FpShotFile

Description

The information about the media fingerprint file.

ParameterTypeDescription
FileIdStringThe ID of the file.
PrimaryKeyStringThe primary key of the file user.
InputFileAliyunOSSFileThe OSS URL of the file.

FpFileDeleteJob

Description

The details of a job of deleting media fingerprint files.

ParameterTypeDescription
IdStringThe ID of the job.
PipelineIdStringThe ID of the MPS queue.
StatusStringThe status of the job.
CodeStringThe error code returned when the job fails.
MessageStringThe error message returned when the job fails.
UserDataStringThe custom data.
FpDBIdStringThe ID of the media fingerprint library.
FileIdsStringThe IDs of the media fingerprint files to be deleted.
CreationTimeStringThe point in time when the job was created.
FinishTimeStringThe point in time when the job was complete.

FpDBDeleteJob

Description

The details of a job of deleting media fingerprint libraries.

ParameterTypeDescription
IdStringThe ID of the job.
PipelineIdStringThe ID of the MPS queue.
DelTypeStringThe operation type.
StatusStringThe status of the job.
MessageStringThe error message returned when the job fails.
CodeStringThe error code returned when the job fails.
UserDataStringThe custom data.
FpDBIdStringThe ID of the media fingerprint library.
CreationTimeStringThe point in time when the job was created.
FinishTimeStringThe point in time when the job was complete.