手动调用接口进行翻译操作

通过JavaScript调用一个方法，传入翻译文本进行翻译，并获得翻译结果
它会自动获取你当前设置的本地语种、以及当前要显示为何种语种，来进行翻译。

使用方式

传入参数可以有多种类型，但是返回的结果都是相同的，以下有几种方式提供参考：

方式一：传入一串翻译文本

  1. translate.request.translateText('你好，我是翻译的内容', function(data){
  2.     //打印翻译结果
  3.     console.log(data);
  4. });

执行示例：

方式二：传入多个翻译文本

  1. var texts = ['我是翻译的第一句','我是翻译的第二句','我是翻译的第三句'];
  2. translate.request.translateText(texts, function(data){
  3.     //打印翻译结果
  4.     console.log(data);
  5. });

执行示例：

方式三：自定义从什么语言翻译为什么语言

  1. var obj = {
  2.     from:'chinese_simplified',
  3.     to:'english',
  4.     texts: ['我是翻译的第一句','我是翻译的第二句','我是翻译的第三句']
  5. }
  6. translate.request.translateText(obj, function(data){
  7.     //打印翻译结果
  8.     console.log(data);
  9. });

执行示例：

注意：

  1. 方式三需要 translate.js v3.12.0.20241210 及以上版本才支持
  2. from 也就是原文语种，如果你用的是大模型翻译等可以自动识别原文语种的，这里你直接传入一个固定字符 ‘auto’ 即可。

参数说明

  • 第一个参数: 可传入要翻译的文本、以及文本数组、以及json对象。
  • 第二个参数: 翻译接口的请求响应是 200 时的处理函数（注意，并不代表翻译成功）。传入如
    function(data){ console.log(data); }
    注意，返回的data.result 为 1，则是翻译成功。 为0则是出错，可通过data.info 得到错误原因。 更详细说明参考： http://api.zvo.cn/translate/service/20230807/translate.json.html
  • 第三个参数: 这里，还可以传入第三个参数，表示翻译接口响应非200时的异常处理。 传入如 :
    function(xhr){ console.log(xhr); } 其中 xhr 是 XMLHttpRequest 对象，可以通过 xhr.status 获取响应状态码，通过 xhr.responseText 获取响应内容，通过 xhr.data 获取请求发送的内容 (此参数有 JackPennnnn 进行贡献补充 )
    使用示例：
    1. translate.request.translateText({
    2.   from:'chinese_simplified',
    3.   to:'english',
    4.   texts: ['我是翻译的第一句','我是翻译的第二句','我是翻译的第三句']
    5. }, function(data){
    6.   //打印翻译结果
    7.   if(data.result == 1){
    8.       console.log(data); //翻译成功
    9.   }else{
    10.       console.log('翻译接口出错,错误信息：'+info)
    11.   }
    12. }, function(xhr){
    13.   //打印翻译失败后的信息
    14.   console.log('翻译接口响应失败，响应码：'+xhr.status+', 响应内容：'+xhr.responseText);
    15. });