建立一個Console專案并且加入SDK套件

首先建立一個C#的Console專案。

當專案建立起來了之後，安裝套件Microsoft.ProjectOxford.Face。可以透過GUI的界面也可以透過Package Management Console輸入Install-Package Microsoft.ProjectOxford.Face

準備需要的參數以及建立出FaceServiceClient

剛剛裝好的SDK包含了一個class叫做FaceServiceClient，這個class充當了和Face Api溝通的橋梁，因此要使用任何服務都是透過這個class。

還記得上篇用Postman測試的時候有兩個參數是需要的：

1. subscriptionKey - 建立服務的時候得到的key
2. api網址 - 因爲key會對應到location，因此api網址也和location不同而不同

因此，需要先準備好這些内容：

static void Main(string[] args)
{
	var subscriptionKey = "";
	var enpointUrl = "https://eastasia.api.cognitive.microsoft.com/face/v1.0";
	var client = new FaceServiceClient(subscriptionKey, enpointUrl);
}

呼叫Detect以及傳入returnFaceAttributes

接下來就是呼叫Detect服務來識別圖片裡面的人物，這邊要做幾個處理：

1. 準備好要識別的圖片網址
2. 準備好要傳入的returnFaceAttributes
3. 呼叫Detect服務

綜合上面提到的幾個調整，程式碼增加了：

.....

var imageUrl = "https://raw.githubusercontent.com/Microsoft/Cognitive-Face-Windows/master/Data/detection1.jpg";

var faceAttr = new[] { FaceAttributeType.Age, 
	FaceAttributeType.Gender, FaceAttributeType.Emotion };
	
var faces = await client.DetectAsync(imageUrl, returnFaceAttributes: faceAttr);

這邊使用到了async以及await，因此main這個method的signature要調整為static async Task Main(string[] args)。由於async main是C# 7.1加入的keyword，如果Visual Studio build有出現錯誤，記得對Project點右鍵，選擇Property，然後選擇Build -> Advance，然後Language Version選擇C# 7.1以上即可：

輸出得到的結果

最後把識別出來的圖片人物識別内容輸出到console，因此在加上：

Console.WriteLine($"這張圖片有以下幾個人臉被識別出來：");

foreach (var item in faces)
{
	Console.WriteLine($"\t 人物：{item.FaceId} \t " +
		$"開心程度：{item.FaceAttributes.Emotion.Happiness} " +
		$"\t 年齡：{item.FaceAttributes.Age} " +
		$"\t 性別：{item.FaceAttributes.Age}");
}

Console.ReadLine();

測試結果

接下來就是直接呼叫看看執行起來是什麽結果。