更新时间:2024-12-09 GMT+08:00
分享

自定义指定场景文案

SetCustomUIText

接口描述

该接口用于自定义指定场景文案。

注意事项

  1. 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。

方法定义

1
HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetCustomUIText(const HwmCustomSceneTextInfoList* customSceneTextInfoList);

回调函数

1
virtual void OnSetCustomUITextResult(hwmsdk::HwmErrCode ret, const char* reason) {};

参数描述

表1 结构体HwmCustomSceneTextInfoList参数说明

参数

类型

描述

customSceneTextInfoListSize

unsigned int

自定义场景文案信息列表长度。

customSceneTextInfoList

HwmCustomSceneTextInfo*

自定义场景文案信息列表。

表2 结构体HwmCustomSceneTextInfo参数说明

参数

类型

描述

scene

HwmUICustomTextScene

自定义文案场景 。

sceneTextListSize

unsigned int

自定义文案列表长度 。

sceneTextInfoList

HwmUICustomTextInfo*

自定义文案列表。

表3 枚举HwmUICustomTextScene说明

枚举值

描述

CLOUD_RECORD_FINISHED_ALERT_SCENE

云录制结束通知修改场景。

CLOUD_RECORD_MENU_TITLE_TEXT_SCENE

录制弹框菜单中的云录制标题。

CLOUD_RECORD_MENU_DES_TEXT_SCENE

录制弹框菜单中的云录制描述。

MAIN_WINDOW_CLOUD_RECORD_DES_TEXT_SCENE

主窗口中的云录制描述。

表4 结构体HwmUICustomTextInfo参数说明

参数

类型

描述

languageType

HwmLanguage

语言类型 。

languageCode

char[]

自定义语言区域名。

customText

char[]

用户自定义文案。

表5 返回值

类型

描述

HwmErrCode

成功返回0,其他值表示失败。失败返回值见错误码参考

示例代码
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
/**
* 自定义指定场景文案
*/
void demoCustomSceneContentDlg::OnBnClickedOk()
{
    hwmsdkagent::HwmCustomSceneTextInfo textInfo;
    AssembleCustomSceneTextInfo(textInfo);

    hwmsdkagent::HwmCustomSceneTextInfoList data{};
    if (textInfo.sceneTextListSize == 0)
    {
        data.customSceneTextInfoListSize = 0;
        data.customSceneTextInfoList = nullptr;
    }
    else
    {
        data.customSceneTextInfoListSize = 1;
        // 申请结构体内存
        data.customSceneTextInfoList = new (std::nothrow)hwmsdkagent::HwmCustomSceneTextInfo[data.customSceneTextInfoListSize];
        if (data.customSceneTextInfoList == nullptr)
        {
            return;
        }
        data.customSceneTextInfoList[0] = std::move(textInfo);
    }

    hwmsdk::HwmErrCode ret = hwmsdkagent::SetCustomUIText(&data);
    if (ret != hwmsdk::HWM_COMMON_SUCCESS)
    {
        CTools::OutputRetStr("Custom scene content error");
    }
    // 释放结构体内存
    for (int i = 0; i < data.customSceneTextInfoListSize; i++)
    {
        if (data.customSceneTextInfoList[i].sceneTextList != nullptr)
        {
            delete data.customSceneTextInfoList[i].sceneTextList;
            data.customSceneTextInfoList[i].sceneTextList = nullptr;
        }
    }

    if (data.customSceneTextInfoList != nullptr)
    {
        delete data.customSceneTextInfoList;
        data.customSceneTextInfoList = nullptr;
    }
}

相关文档