481 lines
19 KiB
Python
481 lines
19 KiB
Python
# Copyright 2020 Baidu, Inc.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
|
|
# except in compliance with the License. You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software distributed under the
|
|
# License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
|
|
# either express or implied. See the License for the specific language governing permissions
|
|
# and limitations under the License.
|
|
|
|
"""
|
|
This module provides a client class for MMS.
|
|
"""
|
|
|
|
import copy
|
|
import json
|
|
import logging
|
|
from builtins import str
|
|
from builtins import bytes
|
|
|
|
from baidubce import compat
|
|
from baidubce.auth import bce_v1_signer
|
|
from baidubce.bce_base_client import BceBaseClient
|
|
from baidubce.http import bce_http_client
|
|
from baidubce.http import handler
|
|
from baidubce.http import http_methods
|
|
from baidubce.utils import required
|
|
|
|
_logger = logging.getLogger(__name__)
|
|
|
|
|
|
class MmsClient(BceBaseClient):
|
|
"""
|
|
mms client
|
|
"""
|
|
|
|
def __init__(self, config=None):
|
|
"""init"""
|
|
BceBaseClient.__init__(self, config)
|
|
|
|
@required(lib_name=(bytes, str), params=dict)
|
|
def create_video_lib(self, lib_name, params=None, config=None):
|
|
"""
|
|
create video lib.
|
|
:param lib_name: video lib name
|
|
:param params: description for this request
|
|
:type params: dict
|
|
:return: **dict**
|
|
"""
|
|
body = {
|
|
'name': lib_name
|
|
}
|
|
if params is not None:
|
|
if 'description' in params:
|
|
body['description'] = params['description']
|
|
if 'scoreThreshold' in params:
|
|
body['scoreThreshold'] = params['scoreThreshold']
|
|
if 'videoScoreThreshold' in params:
|
|
body['videoScoreThreshold'] = params['videoScoreThreshold']
|
|
if 'frameType' in params:
|
|
body['frameType'] = params['frameType']
|
|
if 'interval' in params:
|
|
body['interval'] = params['interval']
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/videolib',
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(lib_id=(bytes, str))
|
|
def delete_video_lib(self, lib_id, config=None):
|
|
"""
|
|
delete video lib by lib_id.
|
|
:param lib_id: video lib id
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
lib_id),
|
|
headers={b'Content-Type': b'application/json'},
|
|
params={b'deleteLibById': b''},
|
|
config=config)
|
|
|
|
@required(lib_name=(bytes, str), params=dict)
|
|
def create_image_lib(self, lib_name, params=None, config=None):
|
|
"""
|
|
create image lib.
|
|
:param lib_name: image lib name
|
|
:param params: params for this request
|
|
:type params: dict
|
|
:return: **BceResponse**
|
|
"""
|
|
body = {
|
|
'name': lib_name
|
|
}
|
|
if params is not None:
|
|
if 'description' in params:
|
|
body['description'] = params['description']
|
|
if 'scoreThreshold' in params:
|
|
body['scoreThreshold'] = params['scoreThreshold']
|
|
if 'frameType' in params:
|
|
body['frameType'] = params['frameType']
|
|
if 'interval' in params:
|
|
body['interval'] = params['interval']
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/imagelib',
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(lib_id=(bytes, str))
|
|
def delete_image_lib(self, lib_id, config=None):
|
|
"""
|
|
delete image lib by lib_id.
|
|
:param lib_id: image lib id
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/imagelib/%s' % compat.convert_to_bytes(
|
|
lib_id),
|
|
headers={b'Content-Type': b'application/json'},
|
|
params={b'deleteLibById': b''},
|
|
config=config)
|
|
|
|
@required(params=dict)
|
|
def list_lib(self, params=None, config=None):
|
|
"""
|
|
list lib.
|
|
:param params: params for this request
|
|
:type params: dict
|
|
:return: **dict**
|
|
"""
|
|
body = {
|
|
'type': params['type']
|
|
}
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/lib/list',
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(params=dict)
|
|
def list_media(self, params=None, config=None):
|
|
"""
|
|
list media.
|
|
:param params: params for this request
|
|
:type params: dict
|
|
:return: **dict**
|
|
"""
|
|
body = {
|
|
'type': params['type'],
|
|
'id': params['id']
|
|
}
|
|
if params is not None:
|
|
if 'pageNo' in params:
|
|
body['pageNo'] = params['pageNo']
|
|
if 'pageSize' in params:
|
|
body['pageSize'] = params['pageSize']
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/lib/item/list',
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(video_lib=(bytes, str), source=(bytes, str))
|
|
def insert_video(self, video_lib, source, description=None, notification=None, config=None):
|
|
"""
|
|
insert a video.
|
|
:param video_lib: video lib
|
|
:type video_lib: string
|
|
:param source: video source
|
|
:type source: string
|
|
:param description: description for this request
|
|
:type description: string
|
|
:param notification: notification for this request
|
|
:type notification: string
|
|
:return: **BceResponse**
|
|
"""
|
|
body = {
|
|
'source': source
|
|
}
|
|
if description is not None:
|
|
body['description'] = description
|
|
if notification is not None:
|
|
body['notification'] = notification
|
|
return self._send_request(http_methods.PUT,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(video_lib=(bytes, str), source=(bytes, str))
|
|
def get_insert_video_task_result(self, video_lib, source, config=None):
|
|
"""
|
|
get insert video task result.
|
|
:param video_lib: video lib
|
|
:type video_lib: string
|
|
:param source: video source
|
|
:type source: string
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.GET,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'source': source},
|
|
config=config)
|
|
|
|
@required(video_lib_id=(bytes, str), media_id=(bytes, str))
|
|
def get_insert_video_task_result_by_id(self, video_lib_id, media_id, config=None):
|
|
"""
|
|
get insert video task result by id.
|
|
:param video_lib_id: video lib id
|
|
:type video_lib_id: string
|
|
:param media_id: video id
|
|
:type media_id: string
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.GET,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib_id),
|
|
params={b'getInsertResponseById': b'',
|
|
b'mediaId': media_id},
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
config=config)
|
|
|
|
@required(video_lib=(bytes, str), source=(bytes, str))
|
|
def delete_video(self, video_lib, source, config=None):
|
|
"""
|
|
delete a video.
|
|
:param video_lib: video lib
|
|
:type video_lib: string
|
|
:param source: video source
|
|
:type source: string
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'deleteVideo': b'',
|
|
b'source': source},
|
|
config=config)
|
|
|
|
@required(video_lib_id=(bytes, str), media_id=(bytes, str))
|
|
def delete_video_by_id(self, video_lib_id, media_id, config=None):
|
|
"""
|
|
delete a video by id.
|
|
:param video_lib_id: video lib id
|
|
:type video_lib_id: string
|
|
:param media_id: video id
|
|
:type media_id: string
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib_id),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'deleteVideoById': b'',
|
|
b'mediaId': media_id},
|
|
config=config)
|
|
|
|
@required(video_lib=(bytes, str), source=(bytes, str))
|
|
def create_search_video_by_video_task(self, video_lib, source, description=None, notification=None, config=None):
|
|
"""
|
|
create search video by video task.
|
|
:param video_lib: video lib
|
|
:type video_lib: string
|
|
:param source: video source
|
|
:type source: string
|
|
:param description: description for this request
|
|
:type description: string
|
|
:param notification: notification for this request
|
|
:type notification: string
|
|
:return: **BceResponse**
|
|
"""
|
|
body = {
|
|
'source': source
|
|
}
|
|
if description is not None:
|
|
body['description'] = description
|
|
if notification is not None:
|
|
body['notification'] = notification
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'searchByVideo': b''},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(video_lib=(bytes, str), source=(bytes, str))
|
|
def get_search_video_by_video_task_result(self, video_lib, source, config=None):
|
|
"""
|
|
get search video by video task result.
|
|
:param video_lib: video lib
|
|
:type video_lib: string
|
|
:param source: video source
|
|
:type source: string
|
|
:return: **BceResponse**
|
|
"""
|
|
|
|
return self._send_request(http_methods.GET,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'searchByVideo': b'',
|
|
b'source': source},
|
|
config=config)
|
|
|
|
@required(video_lib=(bytes, str), task_id=(bytes, str))
|
|
def get_search_video_by_video_task_result_by_id(self, video_lib, task_id, config=None):
|
|
"""
|
|
get search video by video task result by id.
|
|
:param video_lib: video lib
|
|
:type video_lib: string
|
|
:param task_id: video search task id
|
|
:type task_id: string
|
|
:return: **BceResponse**
|
|
"""
|
|
|
|
return self._send_request(http_methods.GET,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'getSearchResponseByTaskId': b'',
|
|
b'taskId': task_id},
|
|
config=config)
|
|
|
|
@required(video_lib=(bytes, str), source=(bytes, str))
|
|
def search_video_by_image(self, video_lib, source, description=None, config=None):
|
|
"""
|
|
search video by image.
|
|
:param video_lib: video lib
|
|
:type video_lib: string
|
|
:param source: image source
|
|
:type source: string
|
|
:param description: description for this request
|
|
:type description: string
|
|
:return: **BceResponse**
|
|
"""
|
|
body = {
|
|
'source': source
|
|
}
|
|
if description is not None:
|
|
body['description'] = description
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/videolib/%s' % compat.convert_to_bytes(
|
|
video_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'searchByImage': b''},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(image_lib=(bytes, str), source=(bytes, str))
|
|
def insert_image(self, image_lib, source, description=None, config=None):
|
|
"""
|
|
insert an image.
|
|
:param image_lib: image lib
|
|
:type image_lib: string
|
|
:param source: image source
|
|
:type source: string
|
|
:param description: description for this request
|
|
:type description: string
|
|
:return: **BceResponse**
|
|
"""
|
|
body = {
|
|
'source': source
|
|
}
|
|
if description is not None:
|
|
body['description'] = description
|
|
return self._send_request(http_methods.PUT,
|
|
b'/v2/imagelib/%s' % compat.convert_to_bytes(
|
|
image_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@required(image_lib=(bytes, str), source=(bytes, str))
|
|
def delete_image(self, image_lib, source, config=None):
|
|
"""
|
|
delete a video.
|
|
:param image_lib: image lib
|
|
:type image_lib: string
|
|
:param source: image source
|
|
:type source: string
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/imagelib/%s' % compat.convert_to_bytes(
|
|
image_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'deleteImage': b'',
|
|
b'source': source},
|
|
config=config)
|
|
|
|
@required(image_lib_id=(bytes, str), media_id=(bytes, str))
|
|
def delete_image_by_id(self, image_lib_id, media_id, config=None):
|
|
"""
|
|
delete a video.
|
|
:param image_lib_id: image lib id
|
|
:type image_lib_id: string
|
|
:param media_id: image id
|
|
:type media_id: string
|
|
:return: **BceResponse**
|
|
"""
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/imagelib/%s' % compat.convert_to_bytes(
|
|
image_lib_id),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'deleteImageById': b'',
|
|
b'mediaId': media_id},
|
|
config=config)
|
|
|
|
@required(image_lib=(bytes, str), source=(bytes, str))
|
|
def search_image_by_image(self, image_lib, source, description=None, config=None):
|
|
"""
|
|
search image by image.
|
|
:param image_lib: image lib
|
|
:type image_lib: string
|
|
:param source: image source
|
|
:type source: string
|
|
:param description: description for this request
|
|
:type description: string
|
|
:return: **BceResponse**
|
|
"""
|
|
body = {
|
|
'source': source
|
|
}
|
|
if description is not None:
|
|
body['description'] = description
|
|
return self._send_request(http_methods.POST,
|
|
b'/v2/imagelib/%s' % compat.convert_to_bytes(
|
|
image_lib),
|
|
headers={
|
|
b'Content-Type': b'application/json'},
|
|
params={b'searchByImage': b''},
|
|
body=json.dumps(body),
|
|
config=config)
|
|
|
|
@staticmethod
|
|
def _merge_config(self, config):
|
|
if config is None:
|
|
return self.config
|
|
else:
|
|
new_config = copy.copy(self.config)
|
|
new_config.merge_non_none_values(config)
|
|
return new_config
|
|
|
|
def _send_request(
|
|
self, http_method, path,
|
|
body=None, headers=None, params=None,
|
|
config=None,
|
|
body_parser=None):
|
|
config = self._merge_config(self, config)
|
|
if body_parser is None:
|
|
body_parser = handler.parse_json
|
|
|
|
return bce_http_client.send_request(
|
|
config, bce_v1_signer.sign, [handler.parse_error, body_parser],
|
|
http_method, path, body, headers, params)
|