Szybki start: programowe tłumaczenie tekstu

Konfigurowanie projektu programu Visual Studio

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

   Wskazówka

   Jeśli dopiero zaczynasz korzystać z 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.

   

4. Na stronie Twórz nowy projekt wprowadź konsolę w polu wyszukiwania. Wybierz szablon Aplikacja konsolowa, a następnie wybierz pozycję Dalej.

   

5. . Pozostaw niezaznaczone pole wyboru "Umieść rozwiązanie i projekt w tym samym katalogu", a następnie wybierz przycisk Dalej.

   

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.

   

Instalowanie pakietu Newtonsoft.json za pomocą narzędzia NuGet

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

   

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

   

3. Aby dodać pakiet do projektu, wybierz pozycję Zainstaluj w odpowiednim oknie menedżera pakietów.

   

Kompilowanie aplikacji w języku C#

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 zaktualizujesz zmienną kluczową przy użyciu wartości z wystąpienia usługi Translator w portalu 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);
        }
    }
}

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 F5.

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

Konfigurowanie środowiska języka Go

Do pisania aplikacji języka Go można użyć dowolnego edytora tekstów. Zalecamy używanie najnowszej wersji Visual Studio Code oraz rozszerzenia Go.

1. Upewnij się, że zainstalowano najnowszą wersję języka Go :

   • Go Pobierz wersję języka programowania dla systemu operacyjnego.

   • Po zakończeniu pobierania uruchom instalatora.

   • Otwórz wiersz polecenia i wprowadź następujące polecenie, aby potwierdzić zainstalowanie języka Go:

       go version
     

Kompilowanie aplikacji języka Go

1. W oknie konsoli (takim jak cmd, PowerShell lub Bash) utwórz nowy katalog dla aplikacji o nazwie translator-app i przejdź do niego.

2. Utwórz nowy plik GO o nazwie translation.go z katalogu translator-app .

3. Skopiuj i wklej podany przykładowy kod do pliku translation.go . Upewnij się, że zaktualizujesz zmienną kluczową przy użyciu wartości z wystąpienia usługi Translator w portalu Azure.

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "log"
    "net/http"
    "net/url"
)

func main() {
    key := "<YOUR-TRANSLATOR-KEY>"
    endpoint := "https://api.cognitive.microsofttranslator.com/"
    uri := endpoint + "/translate?api-version=3.0"

    // 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.
    location := "<YOUR-RESOURCE-LOCATION>"

    // Build the request URL. See: https://go.dev/pkg/net/url/#example_URL_Parse
    u, _ := url.Parse(uri)
    q := u.Query()
    q.Add("from", "en")
    q.Add("to", "fr")
    q.Add("to", "zu")
    u.RawQuery = q.Encode()

    // Create an anonymous struct for your request body and encode it to JSON
    body := []struct {
        Text string
    }{
        {Text: "I would really like to drive your car around the block a few times."},
    }
    b, _ := json.Marshal(body)

    // Build the HTTP POST request
    req, err := http.NewRequest("POST", u.String(), bytes.NewBuffer(b))
    if err != nil {
        log.Fatal(err)
    }
    // Add required headers to the request
    req.Header.Add("Ocp-Apim-Subscription-Key", key)
    // location required if you're using a multi-service or regional (not global) resource.
    req.Header.Add("Ocp-Apim-Subscription-Region", location)
    req.Header.Add("Content-Type", "application/json")

    // Call the Translator API
    res, err := http.DefaultClient.Do(req)
    if err != nil {
        log.Fatal(err)
    }

    // Decode the JSON response
    var result interface{}
    if err := json.NewDecoder(res.Body).Decode(&result); err != nil {
        log.Fatal(err)
    }
    // Format and print the response to terminal
    prettyJSON, _ := json.MarshalIndent(result, "", "  ")
    fmt.Printf("%s\n", prettyJSON)
}

Uruchamianie aplikacji języka Go

Po dodaniu przykładowego kodu do aplikacji program Go można wykonać w wierszu polecenia lub terminalu. Upewnij się, że ścieżka monitu jest ustawiona na folder translator-app i użyj następującego polecenia:

 go run translation.go

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

Konfigurowanie środowiska Java

• Musisz mieć najnowszą wersję programu Visual Studio Code lub preferowanego środowiska IDE. ZobaczJava w programie Visual Studio Code.

  Wskazówka

  • Program Visual Studio Code oferuje pakiet kodowania dla języka Java dla systemów Windows i macOS. Pakiet kodowania jest pakietem programu VS Code, zestawem Java Development Kit (JDK) i kolekcją sugerowanych rozszerzeń firmy Microsoft. Pakiet kodowania może również służyć do naprawiania istniejącego środowiska programistycznego.
  • Jeśli używasz programu VS Code i pakietu programistycznego dla języka Java, zainstaluj rozszerzenie Gradle for Java .

• Jeśli nie używasz programu Visual Studio Code, upewnij się, że w środowisku projektowym zainstalowano następujące elementy:

  • Zestaw Java Development Kit (OpenJDK) w wersji 8 lub nowszej.

  • Gradle, wersja 6.8 lub nowsza.

Tworzenie nowego projektu narzędzia Gradle

1. W oknie konsoli (takim jak cmd, PowerShell lub Bash) utwórz nowy katalog dla aplikacji o nazwie translator-text-app i przejdź do niego.

   mkdir translator-text-app && translator-text-app
   

    mkdir translator-text-app; cd translator-text-app
   

2. gradle init Uruchom polecenie z katalogu translator-text-app. To polecenie tworzy podstawowe pliki kompilacji dla narzędzia Gradle, w tym build.gradle.kts, które są używane w czasie wykonywania do tworzenia i konfigurowania aplikacji.

   gradle init --type basic
   

3. Po wyświetleniu monitu wybierz DSL, a następnie Kotlin.

4. Zaakceptuj domyślną nazwę projektu (translator-text-app), wybierając pozycję Return lub Enter.

5. Zaktualizuj build.gradle.kts za pomocą następującego kodu:

plugins {
  java
  application
}
application {
  mainClass.set("TranslatorText")
}
repositories {
  mavenCentral()
}
dependencies {
  implementation("com.squareup.okhttp3:okhttp:4.10.0")
  implementation("com.google.code.gson:gson:2.9.0")
}

Tworzenie aplikacji Java

1. W katalogu translator-text-app uruchom następujące polecenie:

   mkdir -p src/main/java
   

   Utworzysz następującą strukturę katalogów:

   

2. Przejdź do java katalogu i utwórz plik o nazwie TranslatorText.java.

   Wskazówka

   • Nowy plik można utworzyć przy użyciu programu PowerShell.

   • Otwórz okno programu PowerShell w katalogu projektu, trzymając wciśnięty Shift i klikając folder prawym przyciskiem myszy.

   • Wpisz następujące polecenie New-Item TranslatorText.java.

   • Możesz również utworzyć nowy plik w środowisku IDE o nazwie TranslatorText.java i zapisać go w java katalogu.

3. TranslatorText.java Otwórz plik w środowisku IDE, a następnie skopiuj poniższy przykładowy kod do aplikacji. Zapewnij, że klucz został zaktualizowany przy użyciu jednej z wartości klucza z usługi Translator w portalu Azure:

import java.io.IOException;

import com.google.gson.*;
import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;

public class TranslatorText {
    private static String key = "<your-translator-key";

    // 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 String location = "<YOUR-RESOURCE-LOCATION>";


    // Instantiates the OkHttpClient.
    OkHttpClient client = new OkHttpClient();

    // This function performs a POST request.
    public String Post() throws IOException {
        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(mediaType,
                "[{\"Text\": \"I would really like to drive your car around the block a few times!\"}]");
        Request request = new Request.Builder()
                .url("https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=fr&to=zu")
                .post(body)
                .addHeader("Ocp-Apim-Subscription-Key", key)
                // location required if you're using a multi-service or regional (not global) resource.
                .addHeader("Ocp-Apim-Subscription-Region", location)
                .addHeader("Content-type", "application/json")
                .build();
        Response response = client.newCall(request).execute();
        return response.body().string();
    }

    // This function prettifies the json response.
    public static String prettify(String json_text) {
        JsonParser parser = new JsonParser();
        JsonElement json = parser.parse(json_text);
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        return gson.toJson(json);
    }

    public static void main(String[] args) {
        try {
            TranslatorText translateRequest = new TranslatorText();
            String response = translateRequest.Post();
            System.out.println(prettify(response));
        } catch (Exception e) {
            System.out.println(e);
        }
    }
}

Kompilowanie i uruchamianie aplikacji Java

Po dodaniu przykładowego kodu do aplikacji przejdź z powrotem do głównego katalogu projektu — translator-text-app, otwórz okno konsoli i wprowadź następujące polecenia:

1. Zbuduj aplikację za pomocą polecenia build:

   gradle build
   

2. Uruchom aplikację poleceniem run:

   gradle run
   

Dane wyjściowe tłumaczenia:

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

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

Konfigurowanie projektu Node.js Express

1. Upewnij się, że zainstalowano najnowszą wersję Node.js . Program Node Menedżer pakietów (npm) jest dołączony do instalacji Node.js.

   Wskazówka

   Jeśli dopiero zaczynasz Node.js, wypróbuj moduł Wprowadzenie do Node.js Learn.

2. W oknie konsoli (takim jak cmd, PowerShell lub Bash) utwórz i przejdź do nowego katalogu aplikacji o nazwie translator-app.

       mkdir translator-app && cd translator-app
   

     mkdir translator-app; cd translator-app
   

3. Uruchom polecenie npm init, aby zainicjować aplikację i szkielet projektu.

      npm init
   

4. Określ atrybuty projektu przy użyciu monitów przedstawionych w terminalu.

   • Najważniejsze atrybuty to nazwa, numer wersji i punkt wejścia.
   • Zalecamy zachowanie nazwy index.js dla punktu wejścia. Opis, polecenie testowe, repozytorium GitHub, słowa kluczowe, autor i informacje o licencji są atrybutami opcjonalnymi — można je pominąć dla tego projektu.
   • Zaakceptuj sugestie w nawiasach, wybierając pozycję Return lub Enter.
   • Po zakończeniu poleceń plik package.json zostanie utworzony w katalogu translator-app.

5. Otwórz okno konsoli i użyj narzędzia npm, aby zainstalować bibliotekę axios HTTP i uuid pakiet:

      npm install axios uuid
   

6. index.js Utwórz plik w katalogu aplikacji.

   Wskazówka

   • Nowy plik można utworzyć przy użyciu programu PowerShell.

   • Otwórz okno programu PowerShell w katalogu projektu, trzymając wciśnięty Shift i klikając folder prawym przyciskiem myszy.

   • Wpisz następujące polecenie New-Item index.js.

   • Możesz również utworzyć nowy plik o nazwie index.js w środowisku IDE i zapisać go w translator-app katalogu.

Tworzenie aplikacji JavaScript

Dodaj następujący przykładowy kod do pliku index.js . Upewnij się, że kluczowa zmienna jest aktualizowana przy użyciu wartości z Twojego wystąpienia Translatora w portalu Azure:

    const axios = require('axios').default;
    const { v4: uuidv4 } = require('uuid');

    let key = "<your-translator-key>";
    let 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.
    let location = "<YOUR-RESOURCE-LOCATION>";

    axios({
        baseURL: endpoint,
        url: '/translate',
        method: 'post',
        headers: {
            'Ocp-Apim-Subscription-Key': key,
             // location required if you're using a multi-service or regional (not global) resource.
            'Ocp-Apim-Subscription-Region': location,
            'Content-type': 'application/json',
            'X-ClientTraceId': uuidv4().toString()
        },
        params: {
            'api-version': '3.0',
            'from': 'en',
            'to': 'fr,zu'
        },
        data: [{
            'text': 'I would really like to drive your car around the block a few times!'
        }],
        responseType: 'json'
    }).then(function(response){
        console.log(JSON.stringify(response.data, null, 4));
    })

Uruchamianie aplikacji JavaScript

Po dodaniu przykładowego kodu do aplikacji uruchom program:

1. Przejdź do katalogu aplikacji (translator-app).

2. Wpisz następujące polecenie w terminalu:

   node index.js
   

Dane wyjściowe tłumaczenia:

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

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

Konfigurowanie projektu w języku Python

1. Upewnij się, że zainstalowano najnowszą wersję środowiska Python 3.x . Pakiet instalatora języka Python () jest dołączony do instalacji języka Python.

   Wskazówka

   Jeśli dopiero zaczynasz korzystać z języka Python, wypróbuj moduł Wprowadzenie do języka Python Learn.

2. Otwórz okno terminalu i użyj pip, aby zainstalować bibliotekę Requests i pakiet uuid0.

      pip install requests uuid
   

   Uwaga

   Używamy również wbudowanego pakietu języka Python o nazwie json. Służy do pracy z danymi JSON.

Tworzenie aplikacji w języku Python

1. Utwórz nowy plik języka Python o nazwie translator-app.py w preferowanym edytorze lub środowisku IDE.

2. Dodaj następujący przykładowy kod do pliku translator-app.py . Upewnij się, że zaktualizowałeś klucz, używając jednej z wartości z wystąpienia usługi Translator w portalu Azure.

import requests, uuid, json

# Add your key and endpoint
key = "<your-translator-key>"
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.
location = "<YOUR-RESOURCE-LOCATION>"

path = '/translate'
constructed_url = endpoint + path

params = {
    'api-version': '3.0',
    'from': 'en',
    'to': ['fr', 'zu']
}

headers = {
    'Ocp-Apim-Subscription-Key': key,
    # location required if you're using a multi-service or regional (not global) resource.
    'Ocp-Apim-Subscription-Region': location,
    'Content-type': 'application/json',
    'X-ClientTraceId': str(uuid.uuid4())
}

# You can pass more than one object in body.
body = [{
    'text': 'I would really like to drive your car around the block a few times!'
}]

request = requests.post(constructed_url, params=params, headers=headers, json=body)
response = request.json()

print(json.dumps(response, sort_keys=True, ensure_ascii=False, indent=4, separators=(',', ': ')))

Uruchamianie aplikacji w języku Python

Po dodaniu przykładowego kodu do aplikacji skompiluj i uruchom program:

1. Przejdź do pliku translator-app.py .

2. Wpisz następujące polecenie w konsoli:

   python translator-app.py
   

Dane wyjściowe tłumaczenia:

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

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