Azure TextTranslation REST-ügyfélkódtár JavaScripthez – 1.0.1-es verzió

A szövegfordítás a Translator szolgáltatás felhőalapú REST API-funkciója, amely neurális gépi fordítási technológiát használ a gyors és pontos forrás–cél szöveg fordításhoz valós időben az összes támogatott nyelven.

A Szövegfordítás funkció a következő módszereket támogatja:

Nyelvek. A fordítási, átírási és szótárkeresési műveletek által támogatott nyelvek listáját adja vissza.

Fordít. Egyetlen forrásnyelvi szöveget jelenít meg több célnyelvi szöveggé egyetlen kéréssel.

Átírás. A forrásnyelv karaktereit vagy betűit a célnyelv megfelelő karaktereivé vagy betűivé alakítja.

Észlel. Visszaadja a forráskód nyelvi kódját és egy logikai változót, amely azt jelzi, hogy az észlelt nyelv támogatott-e a szövegfordításhoz és az átíráshoz.

Szótárkeresés. A célnyelv forráskifejezésének megfelelő szavakat ad vissza.

Szótári példa: A forráskifejezés és a célkifejezés pár nyelvtani struktúráját és környezeti példáit adja vissza.

Kérjük, erősen támaszkodjon a REST-ügyfél dokumentációjára, használja ezt a kódtárat

Főbb hivatkozások:

• csomag (NPM)
• API-referenciadokumentáció
• minták

Kezdetekhez

Jelenleg támogatott környezetek

• A Node.js LTS-verziói
• Az Edge, a Chrome, a Safar és a Firefox legújabb verziói

Előfeltételek

• Meglévő Translator-szolgáltatás vagy Cognitive Services-erőforrás.

A @azure-rest/ai-translation-text csomag telepítése

Telepítse az Azure Text Translation REST-ügyfélkódtárat a JavaScripthez npm:

npm install @azure-rest/ai-translation-text

Translator szolgáltatáserőforrás létrehozása

Translator-erőforrást Translator-erőforrás létrehozásaután hozhat létre.

Böngészőtámogatás

JavaScript-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek módjáról további információt a csomagküldő dokumentációbantalál.

Az ügyfél hitelesítése

Az ügyfélkódtárat használó szolgáltatással való interakció a TextTranslationClient osztály egy példányának létrehozásával kezdődik. Szüksége lesz egy API-kulcsra vagy TokenCredential az ügyfélobjektumok példányosításához. További információ a cognitive services hitelesítéséről: A Translator Service-nek küldött kérelmek hitelesítése.

API-kulcs lekérése

A endpoint, a API key és a Region a Cognitive Services-erőforrásból vagy a Translator szolgáltatás erőforrásadataiból szerezheti be az Azure Portal.

Másik lehetőségként az alábbi Azure CLI- kódrészlettel szerezheti be az API-kulcsot a Translator szolgáltatás erőforrásából.

az cognitiveservices account keys list --resource-group <your-resource-group-name> --name <your-resource-name>

TextTranslationClient létrehozása API-kulcs és régió hitelesítő adatok használatával

Miután megkapta az API-kulcs és a régió értékét, hozzon létre egy TranslatorCredential.

A TranslatorCredential értékével létrehozhatja a TextTranslationClient:

const translateCedential = new TranslatorCredential(apiKey, region);
const translationClient = TextTranslationClient(endpoint, translateCedential);

Példák

A következő szakasz több kódrészletet is tartalmaz a fentilétrehozott clienthasználva, és ismerteti az ügyfélkódtárban található fő funkciókat.

Támogatott nyelvek lekérése

Lekéri a Translator más műveletei által jelenleg támogatott nyelvek készletét.

const langResponse = await translationClient.path("/languages").get();

if (isUnexpected(langResponse)) {
  throw langResponse.body;
}

const languages = langResponse.body;

if (languages.translation) {
  console.log("Translated languages:");
  for (const key in languages.translation) {
    const translationLanguage = languages.translation[key];
    console.log(`${key} -- name: ${translationLanguage.name} (${translationLanguage.nativeName})`);
  }
}

if (languages.transliteration) {
  console.log("Transliteration languages:");
  for (const key in languages.transliteration) {
    const transliterationLanguage = languages.transliteration[key];
    console.log(
      `${key} -- name: ${transliterationLanguage.name} (${transliterationLanguage.nativeName})`,
    );
  }
}

if (languages.dictionary) {
  console.log("Dictionary languages:");
  for (const key in languages.dictionary) {
    const dictionaryLanguage = languages.dictionary[key];
    console.log(
      `${key} -- name: ${dictionaryLanguage.name} (${dictionaryLanguage.nativeName}), supported target languages count: ${dictionaryLanguage.translations.length}`,
    );
  }
}

A nyelvekkoncepcionális megvitatásához tekintse meg a szolgáltatás dokumentációját.

Fordít

Egyetlen forrásnyelvi szöveget jelenít meg több célnyelvi szöveggé egyetlen kéréssel.

const inputText = [{ text: "This is a test." }];
const parameters = {
  to: "cs",
  from: "en",
};
const translateResponse = await translationClient.path("/translate").post({
  body: inputText,
  queryParameters: parameters,
});

if (isUnexpected(translateResponse)) {
  throw translateResponse.body;
}

const translations = translateResponse.body;
for (const translation of translations) {
  console.log(
    `Text was translated to: '${translation?.translations[0]?.to}' and the result is: '${translation?.translations[0]?.text}'.`,
  );
}

A fordításánakkoncepcionális ismertetéséhez tekintse meg a szolgáltatás dokumentációját.

Átírás

A forrásnyelv karaktereit vagy betűit a célnyelv megfelelő karaktereivé vagy betűivé alakítja.

const inputText = [{ text: "这是个测试。" }];
const parameters = {
  language: "zh-Hans",
  fromScript: "Hans",
  toScript: "Latn",
};
const transliterateResponse = await translationClient.path("/transliterate").post({
  body: inputText,
  queryParameters: parameters,
});

if (isUnexpected(transliterateResponse)) {
  throw transliterateResponse.body;
}

const translations = transliterateResponse.body;
for (const transliteration of translations) {
  console.log(
    `Input text was transliterated to '${transliteration?.script}' script. Transliterated text: '${transliteration?.text}'.`,
  );
}

A transzliterátumkoncepcionális ismertetéséhez tekintse meg a szolgáltatás dokumentációját.

Mondattörés

A mondathatárok elhelyezkedését azonosítja egy szövegrészben.

const inputText = [{ text: "zhè shì gè cè shì。" }];
const parameters = {
  language: "zh-Hans",
  script: "Latn",
};
const breakSentenceResponse = await translationClient.path("/breaksentence").post({
  body: inputText,
  queryParameters: parameters,
});

if (isUnexpected(breakSentenceResponse)) {
  throw breakSentenceResponse.body;
}

const breakSentences = breakSentenceResponse.body;
for (const breakSentence of breakSentences) {
  console.log(`The detected sentece boundaries: '${breakSentence?.sentLen.join(", ")}'.`);
}

A break mondatfogalmi ismertetéséhez tekintse meg a szolgáltatás dokumentációját.

Szótárkeresés

A célnyelv forráskifejezésének megfelelő szavakat ad vissza.

const inputText = [{ text: "fly" }];
const parameters = {
  to: "es",
  from: "en",
};
const dictionaryResponse = await translationClient.path("/dictionary/lookup").post({
  body: inputText,
  queryParameters: parameters,
});

if (isUnexpected(dictionaryResponse)) {
  throw dictionaryResponse.body;
}

const dictionaryEntries = dictionaryResponse.body;
for (const dictionaryEntry of dictionaryEntries) {
  console.log(
    `For the given input ${dictionaryEntry?.translations?.length} entries were found in the dictionary.`,
  );
  console.log(
    `First entry: '${dictionaryEntry?.translations[0]?.displayTarget}', confidence: ${dictionaryEntry?.translations[0]?.confidence}.`,
  );
}

A szótárkeresésikoncepcionális ismertetéséhez tekintse meg a szolgáltatás dokumentációját.

Szótári példák

Nyelvtani struktúrát és környezeti példákat ad vissza a forráskifejezéshez és a célkifejezés párhoz.

const inputText = [{ text: "fly", translation: "volar" }];
const parameters = {
  to: "es",
  from: "en",
};
const dictionaryResponse = await translationClient.path("/dictionary/examples").post({
  body: inputText,
  queryParameters: parameters,
});

if (isUnexpected(dictionaryResponse)) {
  throw dictionaryResponse.body;
}

const dictionaryExamples = dictionaryResponse.body;
for (const dictionaryExample of dictionaryExamples) {
  console.log(
    `For the given input ${dictionaryExample?.examples?.length} examples were found in the dictionary.`,
  );
  const firstExample = dictionaryExample?.examples[0];
  console.log(
    `Example: '${firstExample.targetPrefix + firstExample.targetTerm + firstExample.targetSuffix}'.`,
  );
}

A szótári példákfogalmi ismertetéséhez tekintse meg a szolgáltatás dokumentációját.

Hibaelhárítás

Amikor a TextTranslator ügyfélkódtár használatával használja a Translator szolgáltatást, a Translator szolgáltatás által visszaadott hibák megegyeznek a REST API-kérésekhez visszaadott HTTP-állapotkódokkal.

Ha például célfordítási nyelv nélkül küld el fordítási kérelmet, a rendszer egy 400 hibát ad vissza, amely "Hibás kérés" értéket jelez.

A szolgáltatás által visszaadott különböző hibakódokat a Szolgáltatás dokumentációjábantalálja.

Fakitermelés

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a AZURE_LOG_LEVEL környezeti változót info. Másik lehetőségként a naplózás futásidőben is engedélyezhető a setLogLevel meghívásával a @azure/logger:

const { setLogLevel } = require("@azure/logger");

setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációit.