教程：使用适用于 C# 的必应视觉搜索 SDK 裁剪图像

项目
03/31/2019

警告

2020 年 10 月 30 日，必应搜索 API 从 Azure AI 服务迁移到必应搜索服务。本文档仅供参考。有关更新的文档，请参阅必应搜索 API 文档。关于为必应搜索创建新的 Azure 资源的说明，请参阅通过 Azure 市场创建必应搜索资源。

使用必应视觉搜索 SDK，可以在查找相似的在线图像之前裁剪图像。此应用程序从包含多个人物的图像中裁剪单个人物，并返回包含在线找到的相似图像的搜索结果。

在 GitHub 上可以找到此应用程序的完整源代码，以及附加的错误处理方法和注释。

本教程展示了如何执行以下操作：

使用必应视觉搜索 SDK 发送请求
使用必应视觉搜索裁剪要搜索的图像区域
接收并处理响应
在响应中查找操作项的 URL

先决条件

任何版本的 Visual Studio 2019。
如果使用的是 Linux/MacOS，则可使用 Mono 运行此应用程序。
已安装 NuGet 自定义搜索包。
- 在 Visual Studio 的解决方案资源管理器中，右键单击项目，并从菜单中选择“管理 NuGet 包” 。安装 Microsoft.Azure.CognitiveServices.Search.CustomSearch 包。安装 NuGet 自定义搜索包还会安装以下程序集：
  - Microsoft.Rest.ClientRuntime
  - Microsoft.Rest.ClientRuntime.Azure
  - Newtonsoft.Json

创建 Azure 资源

通过创建以下 Azure 资源之一开始使用必应视觉搜索 API：

必应搜索 v7 资源

在删除资源前，可通过 Azure 门户使用。
选择 S9 定价层。

多服务资源

在删除资源前，可通过 Azure 门户使用。
在多个 Azure AI 服务中对应用程序使用相同的密钥和终结点。

指定图像裁剪区域

此应用程序裁剪 Microsoft 高级领导团队的以下图像的某个区域。此裁剪区域是使用左上角和右下角的坐标定义的，表示为占整个图像的百分比：

Microsoft 高级领导团队

将通过从裁剪区域创建 ImageInfo 对象并将 ImageInfo 对象加载到 VisualSearchRequest 中裁剪此图像。 ImageInfo 对象还包括图像的 URL：

CropArea CropArea = new CropArea(top: (float)0.01, bottom: (float)0.30, left: (float)0.01, right: (float)0.20);
string imageURL = "https://learn.microsoft.com/azure/cognitive-services/Bing-visual-search/media/ms_srleaders.jpg";
ImageInfo imageInfo = new ImageInfo(cropArea: CropArea, url: imageURL);

VisualSearchRequest visualSearchRequest = new VisualSearchRequest(imageInfo: imageInfo);

搜索与裁剪区域相似的图像

变量 VisualSearchRequest 包含关于图像的裁剪区域及其 URL 的信息。 VisualSearchMethodAsync() 方法会获取结果：

Console.WriteLine("\r\nSending visual search request with knowledgeRequest that contains URL and crop area");
var visualSearchResults = client.Images.VisualSearchMethodAsync(knowledgeRequest: visualSearchRequest).Result;

从 `ImageModuleAction` 获取 URL 数据

必应视觉搜索结果为 ImageTag 对象。每个标记都包含 ImageAction 对象的列表。每个 ImageAction 均包含一个 Data 字段，它是依赖于操作类型的值的列表。

可以使用以下代码打印各种类型：

Console.WriteLine("\r\n" + "ActionType: " + i.ActionType + " -> WebSearchUrl: " + i.WebSearchUrl);

完整的应用程序返回：

ActionType	代码
PagesIncluding WebSearchURL
MoreSizes WebSearchURL
VisualSearch WebSearchURL
ImageById WebSearchURL
RelatedSearches WebSearchURL
Entity -> WebSearchUrl	https://www.bing.com/cr?IG=E40D0E1A13404994ACB073504BC937A4&CID=03DCF882D7386A442137F49BD6596BEF&rd=1&h=BvvDoRtmZ35Xc_UZE4lZx6_eg7FHgcCkigU1D98NHQo&v=1&r=https%3a%2f%2fwww.bing.com%2fsearch%3fq%3dSatya%2bNadella&p=DevEx，5380.1
TopicResults -> WebSearchUrl	https://www.bing.com/cr?IG=E40D0E1A13404994ACB073504BC937A4&CID=03DCF882D7386A442137F49BD6596BEF&rd=1&h=3QGtxPb3W9LemuHRxAlW4CW7XN4sPkUYCUynxAqI9zQ&v=1&r=https%3a%2f%2fwww.bing.com%2fdiscover%2fnadella%2bsatya&p=DevEx，5382.1
ImageResults -> WebSearchUrl	https://www.bing.com/cr?IG=E40D0E1A13404994ACB073504BC937A4&CID=03DCF882D7386A442137F49BD6596BEF&rd=1&h=l-WNHO89Kkw69AmIGe2MhlUp6MxR6YsJszgOuM5sVLs&v=1&r=https%3a%2f%2fwww.bing.com%2fimages%2fsearch%3fq%3dSatya%2bNadella&p=DevEx，5384.1

如上所示，Entity ActionType 包含一个必应搜索查询，该查询返回有关某个可识别人物、地点或事物的信息。 TopicResults 和 ImageResults 类型包含相关图像的查询。列表中的 URL 链接到必应搜索结果。

获取 `PagesIncluding` `ActionType` 图像的 URL

获取实际图像 URL 需要将 ActionType 读取为 ImageModuleAction 的强制转换，其中包含具有值的列表的 Data 元素。每个值是图像的 URL。以下代码将 PagesIncluding 操作类型强制转换为 ImageModuleAction 并读取这些值：

    if (i.ActionType == "PagesIncluding")
    {
        foreach(ImageObject o in (i as ImageModuleAction).Data.Value)
        {
            Console.WriteLine("ContentURL: " + o.ContentUrl);
        }
    }

后续步骤

创建视觉搜索单页 Web 应用

另请参阅

什么是必应视觉搜索 API？

通过