通過指定搜尋欄位和類型進行媒資搜尋過濾-智能媒體服務-阿里雲

媒資搜尋服務支援按指定的欄位和搜尋類型進行搜尋。通過閱讀本文，您可以瞭解各搜尋欄位及對應搜尋類型的詳情。

使用說明

調用SearchMedia，按照本文說明設定對應的入參Match，例如Match設定為title = '中國' and mediaId == 'id' and utcCreate = ('1693367158561','1693367158562')，則對應各欄位說明如下：

重要

調用OpenAPI時，需要對入參Match進行URL編碼，同時確保等號、雙引號、單引號、括弧等為半形符號。

媒資搜尋服務支援對視頻、音頻、圖片和輔助媒資進行搜尋，各搜尋欄位及支援的搜尋類型如下。表格中✔️表示支援，❌表示不支援。

搜尋欄位	資料類型	說明	精確匹配	模糊比對	多值查詢	範圍查詢
title	String	視頻標題。	❌	✔️	❌	❌
description	String	視頻描述。	❌	✔️	❌	❌
tagList	String	視頻標籤。	❌	❌	✔️	❌
mediaId	String	媒資ID。	✔️	❌	❌	❌
cateId	Long	分類ID。	✔️	❌	❌	❌
status	Integer	狀態，取值請參見下表status取值。	✔️	❌	✔️	❌
utcCreate	Long	視頻資訊建立時間，單位：毫秒。	❌	❌	❌	✔️
utcModified	Long	視頻資訊更新時間，單位：毫秒。	❌	❌	❌	✔️
fileInfo.storageLocation	String	儲存地區。	✔️	❌	✔️	❌
ocrInfo.tracks.content	String	字幕。	❌	✔️	❌	❌
aiLabelInfo.category	String	AI分類。	✔️	❌	❌	❌
aiLabelInfo.label_id	String	內容標籤。	✔️	❌	❌	❌
mediaType	String	媒資類型，取值： video：視頻。 image：圖片。 audio：音頻。說明圖片與音視頻無法同時進行搜尋。系統預設為搜尋視頻。	✔️	❌	✔️	❌

媒資搜尋支援精確匹配、模糊比對、多值查詢、範圍查詢和排序欄位共四種搜尋方式。

搜尋類型	說明	文法	樣本
精確匹配	用於搜尋與指定欄位值完全相等的文檔。	field == 'value'	mediaId == '39167e4066a071ee8013e7e7c56b****'
模糊比對	搜尋包含指定字串的文檔，長度不超過60個字元。	field = 'value'	title = '我愛你中國'
多值查詢	可以指定多個欄位進行過濾，只要命中其中一個欄位即返回。最多支援傳入3個欄位。	field in ('value1','value2','value3')	status in ('3','12','18')
範圍查詢	開閉區間規則，匹配欄位值在指定範圍內的文檔。	field = ('value1','value2')	utcCreate = ('1693367158561','1693367158562')

關係字元	描述	文法
and	位於兩個過濾條件之間，表示兩個過濾條件同時命中的文檔才會返回。說明最多支援5個邏輯組合。	field1 = 'value' and field2 = 'value'
or	位於兩個過濾條件之間，表示命中兩個過濾條件之一的文檔即可返回。說明最多支援5個邏輯組合。	field1 = 'value1' or field2 = 'value2'
( )	括弧，範圍查詢。	field = ('value1','value2')
' '	單引號，指定的查詢欄位需要以單引號開始，單引號結束。	field = 'value'
,	逗號，多值查詢使用。用於分隔多個查詢值。	field in ('value1','value2')
( ) [ ]	開閉區間，範圍查詢時使用。()表示不包含邊界值，[]表示包含邊界值。	field = ['value1','value2']
in	多值查詢使用，只要命中其中一個欄位即返回。最多支援傳入3個欄位。	field in ('value1','value2')