同声传译

概述

同声传译功能提供了多语言实时翻译服务，支持在会议中进行多语言同声传译。该功能允许参会者选择不同的语言通道，实现跨语言交流，适用于国际化会议场景。

使用流程

1. 配置同声传译

在会议中配置同声传译功能：

// 发送同声传译语言配置 - 发送传译配置信息
NemoSdkAdaptor::getInstance()->sendTranslationLanguageConfig("remote_url", "call_url", "meeting_id", "config_json");

// 开启额外媒体会话 - 启动额外的媒体会话
NemoSdkAdaptor::getInstance()->openExtraMediaSession();

// 打开语言通道 - 打开指定的语言通道
NemoSdkAdaptor::getInstance()->openLanguageChannel("language_id");

2. 音频通道管理

管理音频采集和通道：

// 开启指定音频通道采集 - 限制音频采集来源
NemoSdkAdaptor::getInstance()->audioCaptureLimitSourceKey("source_key");

// 清除音频通道采集限制 - 清除音频采集限制
NemoSdkAdaptor::getInstance()->clearAudioCaptureLimitSourceKey();

// 设置音频压制 - 启用音频压缩限制
NemoSdkAdaptor::getInstance()->setAudioCompressLimit(true);

3. 翻译员通道

配置翻译员专用通道：

// 打开翻译员通道 - 打开翻译员专用语言通道
NemoSdkAdaptor::getInstance()->openLanguageTranslatorChanel("translator_id");

// 重置回普通通道 - 重置为普通语言通道
NemoSdkAdaptor::getInstance()->resetLanguageChannel();

// 获取当前通道ID - 获取最后使用的语言通道ID
NemoSdkAdaptor::getInstance()->getLastLanguageId();

功能分类

1. 传译配置

发送同声传译语言配置

API: sendTranslationLanguageConfig

接口定义:

virtual void sendTranslationLanguageConfig(const char* remoteUrl, const char* callurl, const char* meetingId, const char* config) = 0;

参数:

remoteUrl (const char*): 会议callurl
callurl (const char*): 当前用户callurl
meetingId (const char*): 会议id
config (const char*): 同声传译配置（json字符串）

示例:

// 配置多语言传译
const char* config = "{\"languages\":[\"zh-CN\",\"en-US\"]}";
NemoSdkAdaptor::getInstance()->sendTranslationLanguageConfig(
    "remote_url", "call_url", "meeting_id", config
);

更新非翻译员同声传译配置

API: refeshTranslateConfig

接口定义:

virtual void refeshTranslateConfig(bool micMute, bool originalChanelMute = false) = 0;

参数:

micMute (bool): 是否关闭麦克风
originalChanelMute (bool): 是否关闭原音，默认为false

示例:

NemoSdkAdaptor::getInstance()->refeshTranslateConfig(false, false);

刷新翻译员同声传译配置

API: refreshTranslatorConfig

接口定义:

virtual void refreshTranslatorConfig(bool micMute) = 0;

参数:

micMute (bool): 是否关闭麦克风

示例:

NemoSdkAdaptor::getInstance()->refreshTranslatorConfig(false);

2. 音频控制

开启指定音频通道采集

API: audioCaptureLimitSourceKey

接口定义:

virtual void audioCaptureLimitSourceKey(int sourceKey, bool enable, bool isContent) = 0;

参数:

sourceKey (int): 指定音频通道
enable (bool): 开启或关闭
isContent (bool): 是否为共享内容

示例:

NemoSdkAdaptor::getInstance()->audioCaptureLimitSourceKey(1, true, false);

sourceKey: 音频源标识

示例:

// 只采集指定通道的音频
NemoSdkAdaptor::getInstance()->audioCaptureLimitSourceKey("channel_1");

清除音频通道采集限制

API: clearAudioCaptureLimitSourceKey

示例:

NemoSdkAdaptor::getInstance()->clearAudioCaptureLimitSourceKey();

设置同声传译原声压制

API: setAudioCompressLimit

接口定义:

virtual void setAudioCompressLimit(int sourceKey, float limit) = 0;

参数:

sourceKey (int): 音频通道id，原生id为0
limit (float): 音频压制比例，默认0.5，范围0到1

示例:

// 启用原声压制
NemoSdkAdaptor::getInstance()->setAudioCompressLimit(0, 0.5f);

// 关闭原声压制
NemoSdkAdaptor::getInstance()->setAudioCompressLimit(0, 1.0f);

3. 媒体会话管理

开启额外媒体会话

API: openExtraMediaSession

接口定义:

virtual void openExtraMediaSession(XYSessionInfo param) = 0;

参数:

param (XYSessionInfo): 额外会话配置

示例:

XYSessionInfo sessionInfo;
sessionInfo.sessionId = 1;
sessionInfo.language = "en-US";
NemoSdkAdaptor::getInstance()->openExtraMediaSession(sessionInfo);

关闭额外媒体会话

API: closeExtraMediaSession

接口定义:

virtual void closeExtraMediaSession(int sessionId) = 0;

参数:

sessionId (int): 会话id

示例:

NemoSdkAdaptor::getInstance()->closeExtraMediaSession(1);

更新额外媒体会话

API: updataExtraMediaSession

接口定义:

virtual void updataExtraMediaSession(XYSessionInfo param) = 0;

参数:

param (XYSessionInfo): 额外会话配置

示例:

XYSessionInfo sessionInfo;
sessionInfo.sessionId = 1;
sessionInfo.language = "zh-CN";
NemoSdkAdaptor::getInstance()->updataExtraMediaSession(sessionInfo);

4. 语言通道管理

打开同声传译非翻译员通道

API: openLanguageChannel

接口定义:

virtual void openLanguageChannel(int id, const char* language, bool audioMute = false, bool originalChanelMute = false) = 0;

参数:

id (int): 同声传译通道id
language (const char*): 语言描述
audioMute (bool): 是否关闭麦克风，默认为false
originalChanelMute (bool): 是否关闭原音，默认为false

示例:

// 打开英语通道
NemoSdkAdaptor::getInstance()->openLanguageChannel(1, "en-US", false, false);

// 打开中文通道
NemoSdkAdaptor::getInstance()->openLanguageChannel(2, "zh-CN", false, false);

// 打开日语通道
NemoSdkAdaptor::getInstance()->openLanguageChannel(3, "ja-JP", false, false);

打开同声传译翻译员通道

API: openLanguageTranslatorChanel

接口定义:

virtual void openLanguageTranslatorChanel(int id, const char* language, bool audioMute = false) = 0;

参数:

id (int): 同声传译通道id
language (const char*): 语言描述
audioMute (bool): 是否关闭麦克风，默认为false

示例:

NemoSdkAdaptor::getInstance()->openLanguageTranslatorChanel(1, "en-US", false);

重置回普通通道

API: resetLanguageChannel

接口定义:

virtual void resetLanguageChannel(bool clearTranslationSource) = 0;

参数:

clearTranslationSource (bool): 是否清除所有同声传译信息

示例:

NemoSdkAdaptor::getInstance()->resetLanguageChannel(true);

获取当前通道ID

API: getLastLanguageId

接口定义:

virtual int getLastLanguageId() = 0;

返回值:

int: 当前通道id

示例:

int currentLanguageId = NemoSdkAdaptor::getInstance()->getLastLanguageId();

完整示例代码

class TranslationManager {
private:
    bool _isTranslationEnabled = false;
    bool _isExtraMediaSessionOpen = false;
    std::string _currentLanguageId = "";
    std::string _currentTranslatorId = "";
    bool _audioCompressEnabled = false;

public:
    // 传译配置
    void enableTranslation(const std::vector<std::string>& languages, 
                          const std::string& defaultLanguage = "en") {
        // 构建配置JSON
        std::string config = R"({
            "languages": [)";
        
        for (size_t i = 0; i < languages.size(); ++i) {
            config += "\"" + languages[i] + "\"";
            if (i < languages.size() - 1) config += ",";
        }
        
        config += R"(],
            "defaultLanguage": ")" + defaultLanguage + R"(",
            "autoTranslate": true
        })";
        
        NemoSdkAdaptor::getInstance()->sendTranslationLanguageConfig(config);
        _isTranslationEnabled = true;
    }

    void refreshTranslationConfig() {
        NemoSdkAdaptor::getInstance()->refeshTranslateConfig();
    }

    void refreshTranslatorConfig() {
        NemoSdkAdaptor::getInstance()->refreshTranslatorConfig();
    }

    // 音频控制
    void limitAudioCapture(const std::string& sourceKey) {
        NemoSdkAdaptor::getInstance()->audioCaptureLimitSourceKey(sourceKey);
    }

    void clearAudioCaptureLimit() {
        NemoSdkAdaptor::getInstance()->clearAudioCaptureLimitSourceKey();
    }

    void setAudioCompress(bool enabled) {
        _audioCompressEnabled = enabled;
        NemoSdkAdaptor::getInstance()->setAudioCompressLimit(enabled);
    }

    // 媒体会话管理
    void openExtraMediaSession() {
        if (!_isExtraMediaSessionOpen) {
            NemoSdkAdaptor::getInstance()->openExtraMediaSession();
            _isExtraMediaSessionOpen = true;
        }
    }

    void closeExtraMediaSession() {
        if (_isExtraMediaSessionOpen) {
            NemoSdkAdaptor::getInstance()->closeExtraMediaSession();
            _isExtraMediaSessionOpen = false;
        }
    }

    void updateExtraMediaSession() {
        NemoSdkAdaptor::getInstance()->updataExtraMediaSession();
    }

    // 语言通道管理
    void openLanguageChannel(const std::string& languageId) {
        _currentLanguageId = languageId;
        NemoSdkAdaptor::getInstance()->openLanguageChannel(languageId);
    }

    void openTranslatorChannel(const std::string& translatorId) {
        _currentTranslatorId = translatorId;
        NemoSdkAdaptor::getInstance()->openLanguageTranslatorChanel(translatorId);
    }

    void resetToNormalChannel() {
        _currentLanguageId = "";
        _currentTranslatorId = "";
        NemoSdkAdaptor::getInstance()->resetLanguageChannel();
    }

    std::string getCurrentLanguageId() {
        return NemoSdkAdaptor::getInstance()->getLastLanguageId();
    }

    // 传译配置回调
    void onTranslationLanguageConfigResult(const XYString& code, const XYString& result) {
        QString errCode(code.str());
        QString resultStr(result.str());
        
        if (errCode == SDKError_NoError) {
            qDebug() << "Translation config result:" << resultStr;
            emit translationConfigResult(resultStr);
        } else {
            qDebug() << "Translation config failed:" << errCode;
            emit translationConfigFailed(errCode);
        }
    }

    // 传译消息回调
    void onTranslatioWSMessageRecieved(const XYString& message) {
        QString messageStr(message.str());
        qDebug() << "Translation WS message received:" << messageStr;
        emit translationMessageReceived(messageStr);
    }

    // Getter方法
    bool isTranslationEnabled() const { return _isTranslationEnabled; }
    bool isExtraMediaSessionOpen() const { return _isExtraMediaSessionOpen; }
    std::string getCurrentLanguageId() const { return _currentLanguageId; }
    std::string getCurrentTranslatorId() const { return _currentTranslatorId; }
    bool isAudioCompressEnabled() const { return _audioCompressEnabled; }
};

语言标识说明

支持的语言标识

语言标识	语言名称	说明
`en`	英语	English
`zh`	中文	Chinese
`ja`	日语	Japanese
`ko`	韩语	Korean
`fr`	法语	French
`de`	德语	German
`es`	西班牙语	Spanish
`ru`	俄语	Russian

功能说明

同声传译特性

同声传译功能提供以下特性：

多语言实时翻译
音频通道分离
翻译员专用通道
原声压制控制
自动语言切换
实时消息传递

音频处理

音频处理功能包括：

指定音频源采集
音频通道限制
原声压制控制
音频质量优化
延迟控制

通道管理

通道管理功能支持：

多语言通道切换
翻译员专用通道
普通通道恢复
通道状态监控
动态通道配置

注意事项

网络要求: 同声传译需要稳定的网络连接
音频质量: 确保音频采集质量以获得更好的翻译效果
延迟控制: 注意音频延迟对翻译体验的影响
权限管理: 翻译员通道需要相应权限
配置同步: 确保所有参会者的传译配置同步

API 参考

同声传译功能

方法	描述	链接
sendTranslationLanguageConfig	同声传译配置设置	查看详情
audioCaptureLimitSourceKey	开启或关闭只采集指定音频通道的声音	查看详情
clearAudioCaptureLimitSourceKey	清除只采集指定音频通道声音设定	查看详情
closeExtraMediaSession	关闭额外媒体会话	查看详情
openExtraMediaSession	开启额外媒体会话	查看详情
updataExtraMediaSession	更新额外媒体会话	查看详情
setAudioCompressLimit	设置同声传译原声压制	查看详情
openLanguageChannel	打开同声传译非翻译员通道（普通参会者）	查看详情
openLanguageTranslatorChanel	打开同声传译翻译员通道	查看详情
resetLanguageChannel	重置回普通通道	查看详情
getLastLanguageId	获取当前通道id	查看详情
refeshTranslateConfig	更新非翻译员同声传译配置	查看详情
refreshTranslatorConfig	刷新翻译员同声传译配置	查看详情

回调相关

回调	描述	链接
onTranslationLanguageConfigResult	传译配置结果回调	查看详情
onTranslatioWSMessageRecieved	传译WebSocket消息接收回调	查看详情

2025-08-13 15:23:37

导出PDF文档