الإشراف باستخدام قوائم الصور المخصصة في C#‎

مقالة
01/18/2024

توفر هذه المقالة معلومات وعينات للتعليمات البرمجية لمساعدتك في بدء استخدام عدة تطوير برامج مشرف المحتوى لـ .NET للأغراض التالية:

إنشاء قائمة صور مخصصة
إضافة الصور إلى القائمة وإزالتها منها
الحصول على معرّفات جميع الصور الموجودة في القائمة
استرداد بيانات تعريف القائمة وتحديثها
تحديث فهرس البحث في القائمة
فحص الصور في مقابل الصور الموجودة في القائمة
حذف جميع الصور من القائمة
حذف القائمة المخصصة

ملاحظة

هناك حد أقصى يبلغ 5 قوائم صور بحيث لا تتجاوز كل قائمة 10000 صورة.

يحاكي تطبيق وحدة التحكم لهذا الدليل بعض المهام التي يمكنك تنفيذها باستخدام واجهة برمجة تطبيقات قائمة الصور.

إذا لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.

قبل أن تتمكن من استخدام خدمات مشرف المحتوى من خلال واجهة برمجة تطبيقات REST أو SDK، ستحتاج إلى مفتاح اشتراك في واجهة برمجة التطبيقات. اشترك في خدمة مشرف المحتوى في مدخل Azure للحصول عليها.

إنشاء مشروع Visual Studio

أضِف مشروع تطبيق وحدة تحكم (.NET Framework) جديداً إلى الحل الخاص بك.

في عينة التعليمة البرمجية، عليك تسمية المشروع ImageLists.
حدد هذا المشروع كمشروع بدء التشغيل الوحيد للحل.

قم بتثبيت الحزم المطلوبة

قم بتركيب حزم NuGet التالية:

Microsoft.Azure.CognitiveServices.ContentModerator
Microsoft.Rest.ClientRuntime
⁧⁩Newtonsoft.Js⁩

تحديث عبارات استخدام البِرنامج

أضِف عبارات using التالية

using Microsoft.Azure.CognitiveServices.ContentModerator;
using Microsoft.Azure.CognitiveServices.ContentModerator.Models;
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.IO;
using System.Threading;

أنشئ عميل مشرف المحتوى

أضِف التعليمة البرمجية التالية لإنشاء عميل في مشرف المحتوى لاشتراكك. قم بتحديث الحقلين AzureEndpoint وCMSubscriptionKey بقيم عنوان URL لنقطة النهاية ومفتاح الاشتراك. يمكنك العثور عليها في علامة التبويب البدء السريع لموردك في مدخل Azure.

/// <summary>
/// Wraps the creation and configuration of a Content Moderator client.
/// </summary>
/// <remarks>This class library contains insecure code. If you adapt this 
/// code for use in production, use a secure method of storing and using
/// your Content Moderator subscription key.</remarks>
public static class Clients
{
	/// <summary>
	/// The base URL for Content Moderator calls.
	/// </summary>
	private static readonly string AzureEndpoint = "YOUR ENDPOINT URL";

	/// <summary>
	/// Your Content Moderator subscription key.
	/// </summary>
	private static readonly string CMSubscriptionKey = "YOUR API KEY";

	/// <summary>
	/// Returns a new Content Moderator client for your subscription.
	/// </summary>
	/// <returns>The new client.</returns>
	/// <remarks>The <see cref="ContentModeratorClient"/> is disposable.
	/// When you have finished using the client,
	/// you should dispose of it either directly or indirectly. </remarks>
	public static ContentModeratorClient NewClient()
	{
		// Create and initialize an instance of the Content Moderator API wrapper.
		ContentModeratorClient client = new ContentModeratorClient(new ApiKeyServiceClientCredentials(CMSubscriptionKey));

		client.Endpoint = AzureEndpoint;
		return client;
	}
}

هام

تذكر إزالة المفتاح من التعليمات البرمجية عند الانتهاء، وعدم نشره على الملأ مطلقًا. للإنتاج، استخدم طريقة آمنة لتخزين بيانات الاعتماد والوصول إليها مثل Azure Key Vault. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من المعلومات.

تهيئة الإعدادات الخاصة بالتطبيق

أضِف الفئات والحقول الثابتة التالية إلى فئة البرنامج في Program.cs.

/// <summary>
/// The minimum amount of time, im milliseconds, to wait between calls
/// to the Image List API.
/// </summary>
private const int throttleRate = 3000;

/// <summary>
/// The number of minutes to delay after updating the search index before
/// performing image match operations against the list.
/// </summary>
private const double latencyDelay = 0.5;

/// <summary>
/// Define constants for the labels to apply to the image list.
/// </summary>
private class Labels
{
	public const string Sports = "Sports";
	public const string Swimsuit = "Swimsuit";
}

/// <summary>
/// Define input data for images for this sample.
/// </summary>
private class Images
{
	/// <summary>
	/// Represents a group of images that all share the same label.
	/// </summary>
	public class Data
	{
		/// <summary>
		/// The label for the images.
		/// </summary>
		public string Label;

		/// <summary>
		/// The URLs of the images.
		/// </summary>
		public string[] Urls;
	}

	/// <summary>
	/// The initial set of images to add to the list with the sports label.
	/// </summary>
	public static readonly Data Sports = new Data()
	{
		Label = Labels.Sports,
		Urls = new string[] {
			"https://moderatorsampleimages.blob.core.windows.net/samples/sample4.png",
			"https://moderatorsampleimages.blob.core.windows.net/samples/sample6.png",
			"https://moderatorsampleimages.blob.core.windows.net/samples/sample9.png"
		}
	};

	/// <summary>
	/// The initial set of images to add to the list with the swimsuit label.
	/// </summary>
	/// <remarks>We're adding sample16.png (image of a puppy), to simulate
	/// an improperly added image that we will later remove from the list.
	/// Note: each image can have only one entry in a list, so sample4.png
	/// will throw an exception when we try to add it with a new label.</remarks>
	public static readonly Data Swimsuit = new Data()
	{
		Label = Labels.Swimsuit,
		Urls = new string[] {
			"https://moderatorsampleimages.blob.core.windows.net/samples/sample1.jpg",
			"https://moderatorsampleimages.blob.core.windows.net/samples/sample3.png",
			"https://moderatorsampleimages.blob.core.windows.net/samples/sample4.png",
			"https://moderatorsampleimages.blob.core.windows.net/samples/sample16.png"
		}
	};

	/// <summary>
	/// The set of images to subsequently remove from the list.
	/// </summary>
	public static readonly string[] Corrections = new string[] {
		"https://moderatorsampleimages.blob.core.windows.net/samples/sample16.png"
	};
}

/// <summary>
/// The images to match against the image list.
/// </summary>
/// <remarks>Samples 1 and 4 should scan as matches; samples 5 and 16 should not.</remarks>
private static readonly string[] ImagesToScreen = new string[] {
	"https://moderatorsampleimages.blob.core.windows.net/samples/sample1.jpg",
	"https://moderatorsampleimages.blob.core.windows.net/samples/sample4.png",
	"https://moderatorsampleimages.blob.core.windows.net/samples/sample5.png",
	"https://moderatorsampleimages.blob.core.windows.net/samples/sample16.png"
};

/// <summary>
/// A dictionary that tracks the ID assigned to each image URL when 
/// the image is added to the list.
/// </summary>
/// <remarks>Indexed by URL.</remarks>
private static readonly Dictionary<string, int> ImageIdMap =
	new Dictionary<string, int>();

/// <summary>
/// The name of the file to contain the output from the list management operations.
/// </summary>
/// <remarks>Relative paths are relative to the execution directory.</remarks>
private static string OutputFile = "ListOutput.log";

/// <summary>
/// A static reference to the text writer to use for logging.
/// </summary>
private static TextWriter writer;

/// <summary>
/// A copy of the list details.
/// </summary>
/// <remarks>Used to initially create the list, and later to update the
/// list details.</remarks>
private static Body listDetails;

ملاحظة

يتضمن مفتاح خدمة مشرف المحتوى حداً لمعدل الطلبات في الثانية (RPS)، وإذا تجاوزت الحد فسوف تطرح عدة تطوير البرامج استثناءً برمز خطأ 429. يحتوي مفتاح الطبقة الحرة على حد واحد لمعدل الطلبات في الثانية.