مشاركة عبر


البدء السريع: ترجمة النص بشكل برمجي

في هذه البداية السريعة، ابدأ باستخدام خدمة المترجم برمجيا لترجمة النصوص بلغة برمجة تختارها. بالنسبة لهذا المشروع، نوصي باستخدام مستوى التسعير المجاني (F0)، أثناء تعلم التكنولوجيا، ثم الترقية لاحقا إلى مستوى مدفوع للإنتاج.

المتطلبات الأساسية

أنت بحاجة إلى اشتراك Azure نشط. إذا لم يكن لديك اشتراك Azure، فيمكنك إنشاء اشتراك مجانا.

  • بمجرد حصولك على اشتراك Azure، قم بإنشاء مورد مترجم في مدخل Microsoft Azure.

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

    • تحتاج إلى المفتاح والنقطة النهائية من المورد لربط تطبيقك بالمترجم. يمكنك لصق المفتاح ونقطة النهاية في التعليمات البرمجية لاحقا في التشغيل السريع. يمكنك العثور على هذه القيم في صفحة مفاتيح مدخل Microsoft Azure ونقطة النهاية :

      لقطة شاشة: مفاتيح مدخل Microsoft Azure وصفحة نقطة النهاية.

      إشعار

      • بالنسبة إلى هذا التشغيل السريع، نوصي باستخدام مورد عمومي أحادي الخدمة لنص المترجم.
      • باستخدام مورد عمومي أحادي الخدمة، يمكنك تضمين رأس تفويض واحد (Ocp-Apim-Subscription-key) مع طلب واجهة برمجة تطبيقات REST. قيمة مفتاح Ocp-Apim-Subscription-key هي مفتاح Azure السري لاشتراك نص المترجم.
      • إذا اخترت استخدام مورد Azure الذكاء الاصطناعي متعدد الخدمات أو مورد مترجم إقليمي، فستكون هناك حاجة إلى رأسين للمصادقة: (Ocp-Api-Subscription-KeyوOcp-Apim-Subscription-Region). قيمة Ocp-Apim-Subscription-Region هي المنطقة المقترنة باشتراكك.
      • لمزيد من المعلومات حول كيفية استخدام رأس Ocp-Apim-Subscription-Region ، راجعرؤوس واجهة برمجة تطبيقات REST لترجمة النص.

Headers

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

لمزيد من المعلومات حول خيارات مصادقة المترجم، راجع الدليل المرجعي للمترجم v3 .

الرأس Value Condition
مفتاح الاشتراك Ocp-Apim مفتاح المترجم الخاص بك من بوابة أزور. مطلوب
Ocp-Apim-Subscription-Region المنطقة التي تم إنشاء المورد فيها. مطلوب عند استخدام مورد Azure الذكاء الاصطناعي متعدد الخدمات أو مورد إقليمي (جغرافي) مثل West US.
اختياري عند استخدام مورد مترجم عالمي أحادي الخدمة.
نوع المحتوى نوع محتوى الحمولة. القيمة المقبولة هي application/json أو charset=UTF-8. مطلوب
طول المحتوى طول نص الطلب . اختياري

هام

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

ترجمة النص

العملية الأساسية للمترجم هي ترجمة النصوص. في هذا التشغيل السريع، يمكنك إنشاء طلب باستخدام لغة برمجة من اختيارك تأخذ مصدرا واحدا (from) وتوفر مخرجين (to). ثم نراجع بعض المعلمات التي يمكن استخدامها لضبط كل من الطلب والاستجابة.

للحصول على معلومات مفصلة حول حدود طلبات ترجمة أزور، راجعحدود طلبات ترجمة النصوص.

إعداد مشروع Visual Studio الخاص بك

  1. تأكد من أن لديك الإصدار الحالي من Visual Studio IDE.

    تلميح

    إذا كنت جديدا على Visual Studio، فجرب الوحدة النمطية مقدمة إلى Visual Studio Learn.

  2. افتح Visual Studio.

  3. في صفحة البدء، اختر إنشاء مشروع جديد.

    لقطة شاشة: نافذة بدء Visual Studio.

  4. في الصفحة إنشاء مشروع جديد، أدخل وحدة التحكم في مربع البحث. اختر قالب تطبيق وحدة التحكم ، ثم اختر التالي.

    لقطة شاشة: صفحة إنشاء مشروع جديد في Visual Studio.

  5. في نافذة الحوار تكوين المشروع الجديد ، أدخل translator_quickstart في مربع اسم المشروع. اترك خانة الاختيار "وضع الحل والمشروع في الدليل نفسه" دون تحديد وحدد التالي.

    لقطة شاشة: نافذة حوار تكوين مشروع جديد في Visual Studio.

  6. في نافذة الحوار معلومات إضافية، تأكد من تحديد .NET 6.0 (دعم طويل الأجل). اترك خانة الاختيار "عدم استخدام عبارات المستوى الأعلى" دون تحديد وحدد إنشاء.

    لقطة شاشة: نافذة حوار المعلومات الإضافية في Visual Studio.

قم بتثبيت حزمة Newtonsoft.json مع NuGet

  1. انقر بزر الماوس الأيمن فوق مشروع translator_quickstart الخاص بك وحدد إدارة حزم NuGet ... .

    لقطة شاشة لمربع البحث عن حزمة NuGet.

  2. حدد علامة التبويب استعراض واكتب Newtonsoft.json.

    لقطة شاشة لنافذة تثبيت حزمة NuGet.

  3. لإضافة الحزمة إلى مشروعك، حدد تثبيت من نافذة إدارة الحزم اليمنى.

    لقطة شاشة لزر تثبيت حزمة NuGet.

إنشاء تطبيق C# الخاص بك

إشعار

  • بدءا من .NET 6 ، تنشئ المشاريع الجديدة التي تستخدم console القالب نمط برنامج جديدا يختلف عن الإصدارات السابقة.
  • يستخدم الإخراج الجديد ميزات C# الحديثة التي تبسط التعليمات البرمجية التي تحتاج إلى كتابتها.
  • عند استخدام الإصدار الأحدث ، ما عليك سوى كتابة نص Main الطريقة. لا تحتاج إلى تضمين عبارات المستوى الأعلى أو التوجيهات باستخدام العمومية أو التوجيهات الضمنية.
  • لمزيد من المعلومات، راجعقوالب C# الجديدة التي تنشئ عبارات المستوى الأعلى.
  1. افتح ملف Program.cs .

  2. احذف الكود الموجود، بما في ذلك السطر Console.WriteLine("Hello World!"). انسخ نموذج التعليمات البرمجية والصقه في ملف Program.cs للتطبيق الخاص بك. تأكد من تحديث المتغير الرئيسي بالقيمة من مثيل مترجم مدخل Microsoft Azure:

using System.Text;
using Newtonsoft.Json;

class Program
{
    private static readonly string key = "<your-translator-key>";
    private static readonly string endpoint = "https://api.cognitive.microsofttranslator.com";

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    private static readonly string location = "<YOUR-RESOURCE-LOCATION>";

    static async Task Main(string[] args)
    {
        // Input and output languages are defined as parameters.
        string route = "/translate?api-version=3.0&from=en&to=fr&to=zu";
        string textToTranslate = "I would really like to drive your car around the block a few times!";
        object[] body = new object[] { new { Text = textToTranslate } };
        var requestBody = JsonConvert.SerializeObject(body);

        using (var client = new HttpClient())
        using (var request = new HttpRequestMessage())
        {
            // Build the request.
            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            // location required if you're using a multi-service or regional (not global) resource.
            request.Headers.Add("Ocp-Apim-Subscription-Region", location);

            // Send the request and get response.
            HttpResponseMessage response = await client.SendAsync(request).ConfigureAwait(false);
            // Read response as a string.
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

قم بتشغيل تطبيق C# الخاص بك

بمجرد إضافة نموذج تعليمات برمجية إلى التطبيق الخاص بك، اختر زر البدء الأخضر بجوار formRecognizer_quickstart لإنشاء البرنامج وتشغيله، أو اضغط على F5.

لقطة شاشة لزر تشغيل البرنامج في Visual Studio.

مخرجات الترجمة:

بعد المكالمة الناجحة، من المفترض أن ترى الرد التالي:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

الخطوات التالية

هذا كل شيء ، تهانينا! لقد تعلمت للتو استخدام المترجم لترجمة النصوص.

استكشف وثائقنا الإرشادية وأعمق في إمكانات خدمة الترجمة: