意见反馈

更新时间:2024-11-18 11:33:12下载pdf

此 SDK 方法接入的是用户反馈1.0版本,即将废弃,推荐接入常见问题与反馈 UI 业务包,对接用户反馈2.0版本。接入常见问题与反馈 UI 业务包后,在 C 端 App 上以及在涂鸦开发者平台上的 用户反馈 均可查看之前历史反馈信息。

智能生活 App SDK 意见反馈相关的所有功能对应 ITuyaFeedbackManagerITuyaFeedbackMsg 类,支持查询反馈会话列表、查询会话中反馈内容列表、查询反馈类型列表、以及添加反馈。

类名 说明
ITuyaFeedbackManager 用户反馈管理类
ITuyaFeedbackMsg 针对某一会话的反馈管理类

场景描述

当用户有问题需要反馈时,通常会在 App 上添加反馈:

  • 添加反馈时,一般先选择反馈类型,然后撰写反馈内容进行提交。
  • 提交反馈后,会按照之前选择的反馈类型生成相应的反馈会话。
  • 解决反馈时,用户也可以在该会话中继续撰写反馈内容并提交,显示在该会话的反馈列表中。

查询反馈会话列表

查询用户已提交反馈会话列表。

接口说明

void getFeedbackManager().getFeedbackList(final ITuyaDataCallback<List<FeedbackBean>> callback);

参数说明

参数 说明
callback 回调,包括查询反馈列表成功和失败,不能为 null

FeedbackBean 数据模型

字段 类型 描述
dateTime String 日期和时间
content String 反馈内容
hdId String 反馈类目 ID
hdType String 反馈类型
title String 类目标题。对于设备故障反馈,此处为设备名称

示例代码

TuyaHomeSdk.getTuyaFeekback().getFeedbackManager().getFeedbackList(new ITuyaDataCallback<List<FeedbackBean>>() {
    @Override
    public void onSuccess(List<FeedbackBean> feedbackTalkBeans) {}
    @Override
    public void onError(String errorCode, String errorMessage) {}
});

获取反馈内容列表

获取用户已提交反馈会话中对应的反馈内容列表。其中,hdIdhdType 字段可以从 FeedbackBean 中获取。

接口说明

void getFeedbackMsg(hdId, hdType).getFeedbackList(final ITuyaDataCallback<List<FeedbackMsgBean>> callback);

参数说明

参数 说明
hdId 反馈类目 ID
hdType 反馈类型
callback 回调,包括获取反馈内容列表成功和失败,不能为 null

FeedbackMsgBean 数据模型

字段 类型 描述
id int 反馈内容 ID
cTime int 反馈时间(时间戳,单位:秒)
content String 反馈内容
hdId String 反馈类目 ID
hdType int 反馈类型

示例代码

TuyaHomeSdk.getTuyaFeekback().getFeedbackMsg(hdId, hdType).getMsgList(new ITuyaDataCallback<List<FeedbackMsgBean>>() {
    @Override
    public void onSuccess(List<FeedbackMsgBean> result) {}
    @Override 
    public void onError(String errorCode, String errorMessage) {}
});

查询反馈类型列表

添加反馈时,可先选择反馈类型。

接口说明

void getFeedbackType(final ITuyaDataCallback<List<FeedbackTypeRespBean>> callback);

参数说明

参数 说明
callback 回调,包括查询反馈类型列表成功和失败,不能为 null

FeedbackTypeRespBean 数据模型

字段 类型 描述
list List 反馈类型列表
type String 列表类别,目前仅有设备和其它

FeedbackTypeBean 数据模型

字段 类型 描述
hdId String 反馈类目 ID
hdType String 反馈类型
title String 类目标题。对于设备故障反馈,此处为设备名称

示例代码

TuyaHomeSdk.getTuyaFeekback().getFeedbackManager().getFeedbackType(new ITuyaDataCallback<List<FeedbackTypeRespBean>>() {
    @Override
    public void onSuccess(List<FeedbackTypeRespBean> feedbackTypeRespBeans) {}
    @Override
    public void onError(String errorCode, String errorMsg) {}
});

添加反馈

添加反馈,提交用户输入的反馈的内容。

接口说明

void addFeedback(final String message,String contact, String hdId, int hdType, final ITuyaDataCallback<FeedbackMsgBean> callback);

参数说明

参数 说明
message 反馈内容
contact 联系方式,例如电话或邮箱地址
hdId 反馈类目 ID
hdType 反馈类型
callback 回调,包含新增成功和失败,不能为 null

示例代码

TuyaHomeSdk.getTuyaFeekback().getFeedbackManager().addFeedback(
    "设备存在故障",
    "abc@qq.com",
    feebackTypeBean.getHdId(),
    feebackTypeBean.getHdType(),
    new ITuyaDataCallback<FeedbackMsgBean>() {
        @Override
        public void onSuccess(FeedbackMsgBean feedbackMsgBean) {}
        @Override
        public void onError(String errorCode, String errorMsg) {}
});