圖片拼接采用圖像拼接技術,即將普通相機拍攝的兩幅或多幅來自不同視點、視角和時間拍攝的具有一定空間重疊的圖像拼接起來,形成一幅寬視角的高質量圖像。本文介紹如何使用圖片拼接功能。
前提條件
- 已創建并獲取AccessKey。具體操作,請參見創建AccessKey。
- 已開通OSS服務、創建存儲空間并上傳文件到存儲空間。具體操作,請參見控制臺上傳文件。
- 已開通智能媒體管理服務。具體操作,請參見開通產品。
- 已通過智能媒體管理控制臺創建項目。具體操作,請參見創建項目。說明
- 您也可以調用API接口創建項目。具體操作,請參見CreateProject - 創建項目。
- 您可以調用ListProjects - 列出所有項目信息的列表接口列出指定地域下已創建的所有項目信息。
使用方法
調用CreateImageSplicingTask - 創建圖片拼接任務接口將多張圖片拼接。
重要
任務開始執行后,任務信息只保存7天,超過7天則無法再獲取。您可以通過以下幾種方式及時獲取任務信息:
調用GetTask - 獲取任務信息或ListTasks - 列出任務接口獲取返回的
TaskId
,查看任務信息。在與智能媒體管理相同的地域下開通MNS服務,并配置訂閱關系,及時獲取任務信息通知,異步通知消息格式請參見異步通知消息格式。關于MNS SDK的更多信息,請參見步驟四:接收和刪除消息。
在與智能媒體管理相同的地域下開通RocketMQ服務,并創建RocketMQ 4.0實例、Topic、Group,及時獲取任務信息通知,異步通知消息格式請參見異步通知消息格式。關于RocketMQ使用的更多信息,請參見調用HTTP協議的SDK收發普通消息。
在與智能媒體管理相同的地域下開通并接入事件總線EventBridge服務,及時獲取任務信息通知。更多信息,請參見智能媒體管理IMM事件。
圖片信息
IMM項目名稱:test-project
待拼接圖片的存儲地址如下:
oss://test-bucket/test-object.jpg1
oss://test-bucket/test-object.jpg2
拼接后的圖片存儲地址:oss://test-bucket/test-target-object.jpg
請求示例
{
"ProjectName": "test-project",
"Sources": "[{\"URI\": \"oss://test-bucket/test-object.jpg1\"},{\"URI\": \"oss://test-bucket/test-object.jpg2\"}]",
"TargetURI": "oss://test-bucket/test-target-object.jpg",
}
返回示例
{
"TaskId": "ImageSplicing-1c73b551-381d-46cc-86ed-16905*****",
"RequestId": "657DE82D-5960-0309-810C-639637*****",
"EventId": "124-1S7JgMQdZ3kWQbmUqXxI3******"
}
示例代碼
以Python SDK為例,圖片拼接的完整示例代碼如下。
# -*- coding: utf-8 -*-
# This file is auto-generated, don't edit it. Thanks.
import sys
import os
from typing import List
from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient
class Sample:
def __init__(self):
pass
@staticmethod
def create_client(
access_key_id: str,
access_key_secret: str,
) -> imm20200930Client:
"""
使用AccessKey ID&AccessKey Secret初始化賬號Client。
@param access_key_id:
@param access_key_secret:
@return: Client
@throws Exception
"""
config = open_api_models.Config(
access_key_id=access_key_id,
access_key_secret=access_key_secret
)
# 填寫訪問的IMM域名。
config.endpoint = f'imm.cn-beijing.aliyuncs.com'
return imm20200930Client(config)
@staticmethod
def main(
args: List[str],
) -> None:
# 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
# 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
# 本示例通過從環境變量中讀取AccessKey,來實現API訪問的身份驗證。如何配置環境變量,請參見http://m.bestwisewords.com/document_detail/2361894.html。
imm_access_key_id = os.getenv("AccessKeyId")
imm_access_key_secret = os.getenv("AccessKeySecret")
client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
sources_0 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg1'
)
sources_1 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg2'
)
create_image_splicing_task_request = imm_20200930_models.CreateImageSplicingTaskRequest(
project_name='test-project',
sources=[
sources_0,
sources_1
],
target_uri='oss://test-bucket/test-target-object.jpg'
)
runtime = util_models.RuntimeOptions()
try:
# 復制代碼運行請自行打印API的返回值。
client.create_image_splicing_task_with_options(create_image_splicing_task_request, runtime)
except Exception as error:
# 如有需要,請打印錯誤信息。
UtilClient.assert_as_string(error.message)
@staticmethod
async def main_async(
args: List[str],
) -> None:
# 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
# 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
# 本示例通過從環境變量中讀取AccessKey,來實現API訪問的身份驗證。如何配置環境變量,請參見http://m.bestwisewords.com/document_detail/2361894.html。
imm_access_key_id = os.getenv("AccessKeyId")
imm_access_key_secret = os.getenv("AccessKeySecret")
client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
sources_0 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg1'
)
sources_1 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg2'
)
create_image_splicing_task_request = imm_20200930_models.CreateImageSplicingTaskRequest(
project_name='test-project',
sources=[
sources_0,
sources_1
],
target_uri='oss://test-bucket/test-target-object.jpg'
)
runtime = util_models.RuntimeOptions()
try:
# 復制代碼運行請自行打印API的返回值。
await client.create_image_splicing_task_with_options_async(create_image_splicing_task_request, runtime)
except Exception as error:
# 如有需要,請打印錯誤信息。
UtilClient.assert_as_string(error.message)
if __name__ == '__main__':
Sample.main(sys.argv[1:])
文檔內容是否對您有幫助?