Translation Callback Information (TranslatorResult)

AndroidiOSWindows
If you are using the Unity engine, see Unity SDK TranslatorResult.

Data Structure

FINTLTranslatorResult: Inherited from FINTLBaseResult, contains basic information

caution

• The translation callback returns "Invalid param, openid or token empty", which is caused by not passing in openid or token.Login again and obtain the correct openid and token from the authResult login state, then pass them into the interface.
• The translation callback returns "msg":"invalid config","ret:91002", which is caused by missing backend configuration. You can contact the Player Network Assistant for individual configuration.

translatorResp Text Translation

Parameters	Type	Explanation
translatorResp	string	Processing results returned by the translation service, text translation needs to be handled independently by the Project side. See translatorResp for details

Code Example:

// Handle translation results
// Example demo of TranslatorResp content returned by FINTLTranslatorResult:
{
    "ret": 0,
    "sub_ret": -1,
    "msg": "success",
    "method_id": 2303,
    "ret_code": 0,
    "ret_msg": "Success",
    "extra_json": "{}",
    "translator_rsp": {
        "debugInfo": null,
        "message": "Success",
        "result": [
            {
                "id": "c5b2802a287f58c9ce250f8c77fc6029",
                "output": "Translated Text",
                "text": "Original Text"
            }
        ],
        "retCode": "0",
        "traceId": "trace"
    },
    "asr_rsp": ""
}

translatorResp

retCode	message	Explanation
0	Success	Success
1001	ParamsError	Parameter Error
1002	ServiceInternalError	Internal Service Error
1003	PermissionError	Permission error, the entered appId may not exist or the token is invalid
1007	rate limit reached	Daily PV or QPM exceeded limit

asrRsp Speech-to-Text

Parameter	Type	Description
asrRsp	string	Processing result returned by the translation service. The ASR speech-to-text translation needs to be handled on the Project side. See asr_rsp for details.

Example code:

// Handle translation results
// Example demo of asrRsp content returned by FINTLTranslatorResult:
{
    "ret": 0,
    "sub_ret": -1,
    "msg": "success",
    "method_id": 2304,
    "ret_code": 0,
    "ret_msg": "Success",
    "extra_json": "{}",
    "translator_rsp": "",
    "asr_rsp": {
        "message": "Success",
        "result": {
            "duration": 1234,
            "voiceTextStr": "Hello World!"
        },
        "retCode": "0",
        "traceId": "traceId"
    }
}

asr_rsp

Name	Type	Description
traceId	string	A unique request ID can be set for tracking requests.
message	string	translator result message
result	result object	An object of Result type
retCode	string	The Service return code. Valid values include: "0" - success, "1001" - parameter error, "1002" - internal Service error.

result

Parameter	Type	Description
voiceTextStr	string	ASR speech text result

asrRsp Speech-to-Text (V2)

Parameters	Type	Description
asrRsp	string	Processing results returned by the Service, ASR speech-to-text translation V2 must be handled independently by the Project side. See asr_rsp (v2) for details

Code Sample:

// Handle translation results
// Example demo of asrRsp content returned by FINTLTranslatorResult:
{
    "ret": 0,
    "sub_ret": -1,
    "msg": "success",
    "method_id": 2306,
    "ret_code": 0,
    "ret_msg": "Success",
    "extra_json": "{}",
    "translator_rsp": "",
    "asr_rsp": {
        "message": "success",
        "result": {
            "end": 0,
            "start": 0,
            "text": "Hello World!",
            "words": null
        },
        "retCode": 0,
        "traceId": "traceId"
    }
}

asr_rsp (V2)

Name	Type	Description
traceId	string	A unique request id can be set to track requests
message	string	translator result message
result	result object	An object of Result type
retCode	string	The Service return code, possible values are: "0" - success, "1001" - parameter error, "1002" - internal Service error

result (V2)

Parameters	Type	Description
text	string	ASR speech-to-text result
start	float64	Only used for streaming platforms
end	float64	Only used for streaming platforms
words	string	Only used for streaming platforms