Szybki start: Azure Cognitive Services Translator

Wypróbuj najnowszą wersję usługi Azure Translator. W tym przewodniku Szybki start zaczniesz używać usługi Translator do tłumaczenia tekstu przy użyciu wybranego języka programowania lub interfejsu API REST. W przypadku tego projektu zalecamy korzystanie z warstwy cenowej Bezpłatna (F0), podczas nauki technologii, a później uaktualniania do warstwy płatnej dla środowiska produkcyjnego.

Wymagania wstępne

Aby rozpocząć pracę, musisz mieć aktywną subskrypcję platformy Azure. Jeśli nie masz subskrypcji platformy Azure, możesz go utworzyć bezpłatnie

  • Po utworzeniu subskrypcji platformy Azure utwórz zasób usługi Translator w Azure Portal.

  • Po wdrożeniu zasobu wybierz pozycję Przejdź do zasobu i pobierz klucz i punkt końcowy.

    • Aby połączyć aplikację z usługą Translator, potrzebny jest klucz i punkt końcowy z zasobu. W dalszej części przewodnika Szybki start wklejesz klucz i punkt końcowy do kodu. Te wartości można znaleźć na stronie klucze Azure Portal i punkt końcowy:

      Zrzut ekranu: Azure Portal klucze i strona punktu końcowego.

      Uwaga

      • W tym przewodniku Szybki start zaleca się użycie zasobu globalnego tłumaczenia tekstu w usłudze Translator.
      • W przypadku zasobu globalnego z jedną usługą dołączysz jeden nagłówek autoryzacji (Ocp-Apim-Subscription-key) z żądaniem interfejsu API REST. Wartość dla klucza Ocp-Apim-Subscription-Key to klucz tajny platformy Azure dla subskrypcji tłumaczenia tekstu w usłudze Translator.
      • Jeśli zdecydujesz się używać wielu usług Cognitive Services lub regionalnego zasobu translatora, wymagane będą dwa nagłówki uwierzytelniania: (Ocp-Api-Subscription-Key i Ocp-Apim-Subscription-Region). Wartość dla regionu Ocp-Apim-Subscription-Region jest regionem skojarzonym z subskrypcją.
      • Aby uzyskać więcej informacji na temat korzystania z nagłówka Ocp-Apim-Subscription-Region , zobaczNagłówki interfejsu API REST tłumaczenia tekstu w usłudze Translator.

Nagłówki

Aby wywołać usługę Translator za pośrednictwem interfejsu API REST, należy dołączyć następujące nagłówki do każdego żądania. Nie martw się, dołączymy nagłówki do przykładowego kodu dla każdego języka programowania.

Aby uzyskać więcej informacji na temat opcji uwierzytelniania w usłudze Translator, zobacz przewodnik referencyjny usługi Translator w wersji 3 .

Nagłówek Wartość Warunek
Ocp-Apim-Subscription-Key Klucz usługi Translator z Azure Portal. Wymagane
Ocp-Apim-Subscription-Region Region, w którym utworzono zasób. Wymagane w przypadku korzystania z wielu usług Cognitive Services lub zasobu
regionalnego (nieglobalnego). • Opcjonalnie w przypadku korzystania z globalnego zasobu usługi Translator z jedną usługą.
Typ zawartości Typ zawartości ładunku. Akceptowana wartość to application/json lub charset=UTF-8. Wymagane
Długość zawartości Długość treści żądania. Opcjonalne

Ważne

Pamiętaj, aby usunąć klucz z kodu po zakończeniu i nigdy nie publikować go publicznie. W przypadku środowiska produkcyjnego użyj bezpiecznego sposobu przechowywania i uzyskiwania dostępu do poświadczeń, takich jak azure Key Vault. Aby uzyskać więcej informacji, zobacz artykuł Dotyczący zabezpieczeń usług Cognitive Services.

Tłumaczenie tekstu

Podstawową operacją usługi Translator jest tłumaczenie tekstu. W tym przewodniku Szybki start utworzysz żądanie przy użyciu wybranego języka programowania, który przyjmuje jedno źródło (from) i udostępnia dwa dane wyjściowe (to). Następnie sprawdzimy niektóre parametry, których można użyć do dostosowania zarówno żądania, jak i odpowiedzi.

Konfigurowanie projektu programu Visual Studio

  1. Upewnij się, że masz bieżącą wersję środowiska IDE programu Visual Studio.

    Porada

    Jeśli jesteś nowym użytkownikm programu Visual Studio, wypróbuj moduł Wprowadzenie do programu Visual Studio Learn.

  2. Otwórz program Visual Studio.

  3. Na stronie Start wybierz pozycję Utwórz nowy projekt.

    Zrzut ekranu: okno uruchamiania programu Visual Studio.

  4. Na stronie Tworzenie nowego projektu wprowadź ciąg console w polu wyszukiwania. Wybierz szablon Aplikacja konsolowa , a następnie wybierz pozycję Dalej.

    Zrzut ekranu: strona tworzenia nowego projektu w programie Visual Studio.

  5. W oknie dialogowym Konfigurowanie nowego projektu wprowadź translator_quickstart wartość w polu Nazwa projektu. Pozostaw niezaznaczone pole wyboru "Umieść rozwiązanie i projekt w tym samym katalogu", a następnie wybierz przycisk Dalej.

    Zrzut ekranu: okno dialogowe konfigurowania nowego projektu w programie Visual Studio.

  6. W oknie dialogowym Dodatkowe informacje upewnij się, że wybrano opcję .NET 6.0 (obsługa długoterminowa). Pozostaw pole wyboru "Nie używaj instrukcji najwyższego poziomu" niezaznaczone i wybierz pozycję Utwórz.

    Zrzut ekranu: okno dialogowe dodatkowych informacji programu Visual Studio.

Instalowanie pakietu Newtonsoft.json przy użyciu narzędzia NuGet

  1. Kliknij prawym przyciskiem myszy projekt translator_quickstart i wybierz polecenie Zarządzaj pakietami NuGet... .

    Zrzut ekranu przedstawiający pole wyszukiwania pakietu NuGet.

  2. Wybierz kartę Przeglądaj i wpisz Newtonsoft.json.

    Zrzut ekranu przedstawiający okno instalacji pakietu NuGet.

  3. Wybierz pozycję Zainstaluj w oknie odpowiedniego menedżera pakietów, aby dodać pakiet do projektu.

    Zrzut ekranu przedstawiający przycisk Instalacji pakietu NuGet.

Kompilowanie aplikacji w języku C#

Uwaga

  • Począwszy od platformy .NET 6, nowe projekty korzystające z console szablonu generują nowy styl programu, który różni się od poprzednich wersji.
  • Nowe dane wyjściowe korzystają z najnowszych funkcji języka C#, które upraszczają pisanie kodu.
  • W przypadku korzystania z nowszej wersji wystarczy napisać treść Main metody . Nie trzeba uwzględniać instrukcji najwyższego poziomu, globalnych dyrektyw using ani niejawnych dyrektyw using.
  • Aby uzyskać więcej informacji, zobaczNowe szablony języka C# generują instrukcje najwyższego poziomu.
  1. Otwórz plik Program.cs .

  2. Usuń istniejący kod, w tym wiersz Console.Writeline("Hello World!"). Skopiuj i wklej przykładowy kod do pliku Program.cs aplikacji. Upewnij się, że zmienna klucza jest aktualizowana przy użyciu wartości z wystąpienia usługi Azure Portal Translator:

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);
        }
    }
}

Uruchamianie aplikacji w języku C#

Po dodaniu przykładowego kodu do aplikacji wybierz zielony przycisk startowy obok formRecognizer_quickstart, aby skompilować i uruchomić program, lub naciśnij klawisz F5.

Zrzut ekranu przedstawiający przycisk Uruchom program w programie Visual Studio.

Dane wyjściowe tłumaczenia:

Po pomyślnym wywołaniu powinna zostać wyświetlona następująca odpowiedź:

[
    {
        "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"
            }
        ]
    }
]

Następne kroki

To wszystko, gratulacje! Wiesz już, jak przetłumaczyć tekst przy użyciu usługi Translator.

Zapoznaj się z naszą dokumentacją z instrukcjami i dowiedz się więcej na temat możliwości usługi tłumaczenia: