智能摄像机 UI 业务包

智能摄像机（IPC）UI 业务包是基于 涂鸦 IPC SDK 开发的一系列摄像机功能相关的面板 SDK。主要包括以下功能：

• 预览面板
• 回放面板
• 云存储面板
• 消息中心面板
• 相册面板
• 设置面板

注意事项

• 建议您只对接预览面板入口，其他功能以预览面板内部流程为准。如果单独对接预览面板之外的入口，可能存在上下文逻辑不对称的风险，需要您每次更新都进行完整功能测试。
• IPC UI 业务包包括 RN 面板功能，建议同步集成 设备控制 UI 业务包。
• 单独使用某个面板路由，注意各版本间的参数差异，业务包不保证前后版本兼容。如有疑问，请联系客户经理或者 提交工单。

集成业务包

1. 参考 框架接入，完成接入 UI 业务包框架。

2. 在模块 build.gradle 中，配置 dependencies 依赖。

   
   dependencies {
       api enforcedPlatform("com.thingclips.smart:thingsmart-BizBundlesBom:${biz_bom_version}")
       api "com.thingclips.smart:thingsmart-bizbundle-camera"
       api "com.thingclips.smart:thingsmart-ipcsdk:${ipc_sdk_version}}"
        //... 其他配置
       api "com.thingclips.smart:thingsmart:${sdk_version}}"
       // 如果接入了小程序，还需要添加以下依赖
       api "com.thingclips.smart:thingsmart-bizbundle-miniapp"
       api "com.thingclips.smart:thingsmart-bizbundle-homekit"
       api "com.thingclips.smart:thingsmart-bizbundle-ipckit"
   }
   
   

   建议业务包与 IPC SDK 版本保持一致。

3. 业务包 5.8.0 及以上版本兼容 Android 14（API 级别 34）。部分产品需要 App 拥有从后台唤起并发起视频呼叫能力，涉及品类包含门铃、可视门锁或者带屏幕控制的 IPC 设备等。需要申请前台服务权限：FOREGROUND_SERVICE_MEDIA_PLAYBACK，在 AndroidManifest.xml 自行添加。更多信息，参考 安卓 14 新政要求。

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
   

功能调用

智能摄像机 (IPC) UI 业务包是涂鸦摄像机各面板的调用对外暴露的接口，包含多个面板的跳转及自定义实现。您可以参考 GitHub SmartBizbundle Demo 下 IPC 部分流程，配置成功摄像头，进行摄像头面板相关操作。

Native 预览面板

摄像机原生预览面板，包括视频实时预览、清晰度切换、声音开关控制、截图、录制、对讲、移动侦测、PTZ 方向控制、收藏点添加/删除、巡航控制等功能。

接口说明

面板通过路由进行跳转，路由地址为 camera_panel_2。

参数说明

参数	说明
extra_camera_uuid	设备 ID，您可以通过家庭的设备列表查询设备 ID

示例代码

  Bundle bundle = new Bundle();
  bundle.putString("extra_camera_uuid", devId);
  UrlBuilder urlBuilder = new UrlBuilder(context, "camera_panel_2").putExtras(bundle);
  UrlRouter.execute(urlBuilder);

RN 预览面板

实现摄像机 RN（React Native）预览面板前，您需要先集成 设备控制 UI 业务包。

接口说明

通过服务化接口 AbsPanelCallerService.goPanelWithCheckAndTip() 可跳转到 RN 面板。

AbsPanelCallerService service = MicroContext.getServiceManager().findServiceByInterface(AbsPanelCallerService.class.getName());
 service.goPanelWithCheckAndTip(IPCPanelActivity.this, bean.getDevId());

其它

以下面板不建议单独使用。若需使用单独某个面板路由，注意各版本间的参数差异，业务包不保证前后版本兼容。如果单独对接以下面板入口而出现功能异常，需要您自行处理。

回放面板

摄像机回放面板，展示的是保存在摄像机存储设备上的视频。包括视频回放、回放日期选择、视频随时间轴拖动播放、播放/暂停、声音控制、截图、录制等功能。

接口说明

面板通过路由进行跳转，路由地址为 camera_playback_panel。

参数说明

参数	说明
extra_camera_uuid	设备 ID
destroyCamera	退出回放页面时，是否执行断开连接，默认为 false

示例代码

Bundle bundle = new Bundle();
bundle.putExtra("extra_camera_uuid", deviceId);
UrlBuilder urlBuilder = new UrlBuilder(context,"camera_playback_panel").putExtras(bundle);
UrlRouter.execute(urlBuilder);

云存储面板

摄像机云存储面板，展示开通云存储功能之后录制保存的云端视频。包括视频云存储播放、云存储日期选择、视频随时间轴拖动播放、播放/暂停、声音控制、截图、录制等功能，移动侦测数据列表展示。

接口说明

面板通过路由进行跳转，路由地址为 camera_cloud_panel。

参数说明

参数	说明
extra_camera_uuid	设备 ID
extra_position	云存储最近一天的某条移动侦测片段数据的时间戳，单位为秒，该参数可不传

示例代码

Bundle bundle = new Bundle();
bundle.putExtra("extra_camera_uuid", deviceId);
UrlBuilder urlBuilder = new UrlBuilder(context,"camera_cloud_panel").putExtras(bundle);
UrlRouter.execute(urlBuilder);

消息中心面板

摄像机消息中心面板，包括摄像机录制过程中产生的各类消息。按日期，消息类型进行展示。消息类别支持图片、视频、纯音频等，可进行预览及单条删除，全部删除操作。

接口说明

面板通过路由进行跳转，路由地址为 camera_message_panel。

参数说明

参数	说明
extra_camera_uuid	设备 ID
extra_album_theme	主题色

示例代码

Bundle bundle = new Bundle();
bundle.putExtra("extra_camera_uuid", deviceId);
UrlBuilder urlBuilder = new UrlBuilder(context,"camera_message_panel").putExtras(bundle);
UrlRouter.execute(urlBuilder);

相册面板

摄像机相册面板，展示的是根据设备 ID 所保存文件。这些文件是在摄像机预览、回放、云视频播放过程中生成的本地截图和录制视频。可进行预览、单条删除、全部删除等操作。

接口说明

面板通过路由进行跳转，路由地址为 ipc_album_panel。

参数说明

参数	说明
extra_camera_uuid	设备 ID

示例代码

Bundle bundle = new Bundle();
bundle.putExtra("extra_camera_uuid", deviceId);
UrlBuilder urlBuilder = new UrlBuilder(context,"ipc_album_panel").putExtras(bundle);
UrlRouter.execute(urlBuilder);

门铃面板

摄像机门铃呼叫接听面板，显示推送过来的门铃消息界面。包括门铃基本信息、实时截图、接听和挂断功能。接听成功后会进入摄像机预览面板。

接口说明

面板通过路由进行跳转，路由地址为 camera_door_bell。

参数说明

参数	说明
devId	设备 ID，一般通过推送过来的消息中提取

示例代码

Bundle bundle = new Bundle();
bundle.putString("devId", deviceId);
UrlBuilder urlBuilder = new UrlBuilder(MicroContext.getApplication(), "camera_door_bell").putExtras(bundle);
UrlRouter.execute(urlBuilder);

视频流门铃面板

摄像机视频流门铃接听面板，显示推送过来的实时视频流门铃消息界面，包括门铃状态信息、接听、挂断功能。门铃接听有一定的时效性，接听成功后进行实时视频通话。结合 门铃呼叫 使用。

接口说明

面板通过路由进行跳转，路由地址为 camera_action_doorbell。

参数说明

参数	说明
extra_camera_uuid	设备 ID，一般通过推送过来的消息中提取
extra_doorbell_auto_accept	布尔型，是否自动接听
msgid	消息 ID ，一般指推送过来的消息

示例代码

Bundle bundle = new Bundle();
bundle.putString("extra_camera_uuid", deviceId);
bundle.putBoolean("extra_doorbell_auto_accept", false);
bundle.putString("msgid", msgid);
UrlBuilder urlBuilder = new UrlBuilder(MicroContext.getApplication(), "camera_action_doorbell").putExtras(bundle);
UrlRouter.execute(urlBuilder);

设置面板

摄像机设置面板，可通过 DP 配置展示，详情请参考 IPC SDK。主要包含：

• 设备图标和名称
• 设备信息（所有者、IP 地址、设备 ID、设备时区、信号强度等）
• 基础设置（隐私开关、基本功能设置、红外夜视功能、亮度与对比度画质调节、工作模式等）
• 高级设置（侦测报警设置、PIR 开关、电源管理设置、铃铛设置、蜂鸣器调节、视频布局、预置点设置等）
• 存储设置（SD 卡容量管理、格式化等）
• 增值服务（云存储购买等）
• 离线提醒
• 其他（常见问题反馈）
• 重启设备
• 移除设备

接口说明

面板通过路由进行跳转，路由地址为 camera_panel_more。

参数说明

参数	说明
extra_camera_uuid	设备 ID

示例代码

Bundle bundle = new Bundle();
bundle.putString("extra_camera_uuid", deviceId);
UrlBuilder urlBuilder = new UrlBuilder(context, panel).putExtras(bundle);
UrlRouter.execute(urlBuilder);

主题设置

主题包括黑色和白色两种，支持涂鸦智能摄像头的回放、云存储、消息中心、设置和本地相册。

接口说明

您可通过 CameraUIThemeUtils.setCurrentThemeId(@ThemeIDs int themeIDs) 方法来设置主题。

CameraUIThemeUtils.setCurrentThemeId(@ThemeIDs int themeIDs);

参数说明

参数	说明
themeId	主题色 ID BLACK_THEME_ID：黑色主题 WHITE_THEME_ID：白色主题

示例代码

CameraUIThemeUtils.setCurrentThemeId(Constants.BLACK_THEME_ID);

面板自定义（已废弃）

智能摄像机 (IPC) UI 业务包支持自定义配置面板。如果您自行实现面板功能，可参考 IPC SDK。

实现方式

进入 app 的 assets 文件夹，找到服务化配置文件 module_app.json，找到要拦截的路由地址进行删除，捕获已删除路由进行自定义跳转。例如，要自定义实现设置页面：

1. 找到设置的路由地址 camera_panel_more，进行删除。

   

2. 参考 框架接入，获取未实现路由地址跳转对应页面。

   ThingWrapper.init(this, new RouteEventListener() {
           @Override
           public void onFaild(int errorCode, UrlBuilder urlBuilder) {
               // 路由原始地址 urlBuilder.originUrl
               ToastUtil.shortToast(ThingPanelSDK.getCurrentActivity(), urlBuilder.originUrl);
           }
       },new ServiceEventListener() {
               @Override
               public void onFaild(String serviceName) {
                   Log.e("service not implement", serviceName);
               }
       });
   

面板路由表（已废弃）

路由 target	功能
camera_panel_2	黑色预览面板
camera_playback_panel	回放面板
camera_cloud_panel	云存储面板
camera_message_panel	消息中心面板
camera_door_bell	门铃来电接听面板
doorbell_camera_panel	门铃预览面板
doorbell_camera_playback_panel	门铃回放面板
camera_action_doorbell	直供电门铃接听面板
camera_panel_more	设置面板
dev_base_info	设置 > 修改设备名称
camera_panel_info	设置 > 设备信息功能
ipc_alarm_detected_feature_list	设置 > 移动侦测设置
helpCenter	设置 > 意见反馈，需要接入 反馈业务包
dev_share_edit	设置 > 设备分享，暂不支持
not_share_support_help	设置 > 共享帮助，暂不支持
AbsCameraOTAService	设置 > 固件信息，需要接入 OTA 业务包

修改设备名称

接口说明

调用智能生活 App SDK 的 renameDevice() 接口进行设备名称的修改。

ThingHomeSdk.newDeviceInstance(deviceId).renameDevice(String deviceName, IResultCallback callback);

参数说明

参数	说明
deviceId	设备 ID
deviceName	设备重命名的名称
callback	IResultCallback 接口，设备重命名成功或失败的回调

示例代码

/**
* 修改设备名称
* @param context
* @param deviceId      设备 ID
* @param deviceName    设备重命名名称
*/
public void renameDevice(final Context context, String deviceId, String deviceName) {
    IThingDevice mDevice = ThingHomeSdk.newDeviceInstance(deviceId);
    mDevice.renameDevice(deviceName, new IResultCallback() {
        @Override
        public void onError(String code, String error) {

        }

        @Override
        public void onSuccess() {

        }
    });
}

修改设备图标

接口说明

调用智能生活 App SDK 的 modifyDeviceImg() 接口进行设备图标的修改。

DeviceInfoRepository deviceInfoRepository = new DeviceInfoRepositoryImpl(context);
ModifyDevInfoInteractor mModifyDevInfoInteractor = new ModifyDevInfoInteractorImpl(deviceInfoRepository);
mModifyDevInfoInteractor.modifyDeviceImg( deviceId, deviceName, imageFile, callback);

参数说明

参数	说明
deviceId	设备 ID
imageFile	文件类型，表示待上传的图片文件
deviceName	设备名称，通过智能生活 App SDK 的 DeviceBean 查询
callback	ModifyDevInfoInteractor.ModifyDeviceImgCallback 接口的回调，上传的图片文件成功或失败的回调

示例代码

/**
* 修改设备头像
*
* @param context
* @param deviceId     设备 ID
* @param iconFilePath 待上传的设备头像地址
*/
public void uploadIcon(final Context context, String deviceId, String iconFilePath) {
    DeviceBean deviceBean = ThingHomeSdk.getDataInstance().getDeviceBean(deviceId);
    String panelName = "";
    if (deviceBean != null) {
        panelName = deviceBean.getName();
    }
    DeviceInfoRepository deviceInfoRepository = new DeviceInfoRepositoryImpl(context);
    ModifyDevInfoInteractor mModifyDevInfoInteractor = new ModifyDevInfoInteractorImpl(deviceInfoRepository);

    mModifyDevInfoInteractor.modifyDeviceImg(deviceId, panelName, new File(iconFilePath),
            new ModifyDevInfoInteractor.ModifyDeviceImgCallback() {
                @Override
                public void onModifyDeviceImgSuccess(String url) {

                }

                @Override
                public void onModifyDeviceImgFailure() {

                }
            });
}

消息推送辅助协议

在 App 进程活跃的情况下，为提高推送消息的到达及时性和成功率，涂鸦智能摄像机开放了消息推送辅助协议。

• 您可以自行实现接入推送渠道，请参考 消息管理。
• 注册涂鸦推送消息监听，查询回调上来的推送消息，进行后续处理。

消息体格式定义示例

    {
        "a": "view",
        "c": "action",
        "cc": "低功耗智能摄像机,someone is ringing the bell.",
        "ct": "fcm You have a visitor",
        "devId": "6cfaf335a8d6e752e0wrpy",
        "msgId": "4da4dcf61573555995",
        "p": {
        "media": 13
    },
        "specialChannel": false,
        "ts": "1573555995000",
        "type": "doorbell"
    }

注册和注销监听

在账号登录成功后注册，在账号退出时进行注销。

接口说明

涂鸦推送辅助协议需在账号登录成功后注册监听，在账号退出时进行注销。

//注册涂鸦推送消息监听
ThingHomeSdk.getCameraInstance().registerCameraPushListener(IThingGetBeanCallback<CameraPushDataBean> callback)

//注销涂鸦推送消息监听
ThingHomeSdk.getCameraInstance().unRegisterCameraPushListener(IThingGetBeanCallback<CameraPushDataBean> callback);

参数说明

参数	说明
callback	IThingGetBeanCallback 接口，监听回调推送消息，CameraPushDataBean 为推送消息封装

CameraPushDataBean 数据模型

字段	类型	描述
devId	String	设备 ID
timestamp	Integer	消息时间戳
etype	String	消息类型
edata	String	消息 ID

示例代码

private IThingHomeCamera homeCamera;
private static IThingGetBeanCallback<CameraPushDataBean> mThingGetBeanCallback = new IThingGetBeanCallback<CameraPushDataBean>() {
    @Override
    public void onResult(CameraPushDataBean o) {
        L.d(TAG, "onMqtt_43_Result on callback");
        L.d(TAG, "消息时间戳：timestamp=" + o.getTimestamp());
        L.d(TAG, "设备 ID：devid=" + o.getDevId());
        L.d(TAG, "消息 ID：msgid=" + o.getEdata());
        L.d(TAG, "消息类型：etype=" + o.getEtype());
    }
};

/**
* 在账号登录成功之后注册
*/
public void registerCameraPushListener() {
    homeCamera = ThingHomeSdk.getCameraInstance();
    if (homeCamera != null) {
        homeCamera.registerCameraPushListener(mThingGetBeanCallback);
    }
}

/**
* 在账号注销之后进行反注册
*/
public void unRegisterCameraPushListener() {
    if (homeCamera != null) {
        homeCamera.unRegisterCameraPushListener(mThingGetBeanCallback);
    }
}

门铃呼叫通知栏

通过上述方式监听到门铃消息时，如果设备采用 Android 10 及以上版本，则 App 处于后台会弹出前台服务通知，同时显示接听、挂断的自定义通知栏界面。

由于接听是通过路由实现，需要您自行开发跳转方式。具体实现步骤如下：

1. 定义 activity-alias，将入口 activity 启动模式设置为 singleTask。

   <activity-alias
               android:name="com.tuya.smart.hometab.activity.main"
               android:exported="true"
               android:targetActivity=".MainActivity">    // 此处为入口需跳转到 activity
               <intent-filter>
                   <action android:name="com.thingclips.smart.action.router" />    // 约定的 action，不能修改
   
                   <category android:name="android.intent.category.DEFAULT" />
               </intent-filter>
           </activity-alias>
   

2. 实现 App 模块中的 RouterPresenter 路由解析的部分即可。

   if (PINNED_MAIN_ALIAS.equals(intent.getComponent().getClassName())) {
           String url = null;
           try {
               url = intent.getStringExtra("url");
           } catch (Throwable t) {
               LogUtil.e(TAG, "get url error", t);
           }
           L.d(TAG, "schemeJump: " + url);
           if (TextUtils.isEmpty(url)) {
               return null;
           }
           Bundle extras = null;
           try {
               extras = intent.getBundleExtra("params");
           } catch (Throwable t) {
               LogUtil.e(TAG, "get params error", t);
           }
           return new RouterPresenter(url, extras);
       }
   

3. 重写 onNewIntent 方法，调用 Router 解析路由。

4. 在 onResume 中执行路由跳转逻辑。

设置页面配置

支持自定义配置设置页面上每项功能的显示、隐藏、单击事件拦截。

接口说明

通过服务化接口 AbsCameraUiService.configCameraSettingCustomItem 传入配置。

public abstract void configCameraSettingCustomItem(List<ThingCameraSettingConfigBean> items);

示例代码

AbsCameraUiService service = MicroServiceManager.getInstance().findServiceByInterface(AbsCameraUiService.class.getName());
if (service != null) {
    List<ThingCameraSettingConfigBean> configs = new ArrayList<>();
    configs.add(new ThingCameraSettingConfigBean("cameraSetting_iconInfoItem", false));
    service.configCameraSettingCustomItem(configs);
}

ThingCameraSettingConfigBean 数据模型

参数	说明
visible	是否显示
operateCallback	单击事件拦截
tag	设置页面每项功能都有一个唯一对应的名称 (name)，见下表所示

tag 列表

tag 名称	功能
cameraSetting_iconInfoItem	设备图标、名称等信息
cameraSetting_infoItem	设备信息
cameraSetting_autoItem	一键执行和自动化
cameraSetting_networkItem	设备网络信息
cameraSetting_thirdPartyItem	支持的第三方服务
cameraSetting_privateModeCfgItem	隐私模式开关
cameraSetting_basicSectionHeaderCfgItem	基础设置标题
cameraSetting_basicFuncCfgItem	基础设置
cameraSetting_nightvisionCfgItem	夜视模式
cameraSetting_irNightCfgItem	红外夜视功能
cameraSetting_displaySettingCfgItem	画面调节
cameraSetting_soundCfgItem	声音调节
cameraSetting_workModeCfgItem	工作模式
cameraSetting_advanceSectionHeaderCfgItem	高级设置标题
cameraSetting_detectCfgItem	侦测报警
cameraSetting_pirFuncCfgItem	PIR
cameraSetting_powerCfgItem	电源管理
cameraSetting_bellCfgItem	铃铛设置
cameraSetting_sirenSettingCfgItem	蜂鸣器调节
cameraSetting_videoLayoutCfgItem	视频布局
cameraSetting_presentPointCfgItem	预设点设置
cameraSetting_onvifCfgItem	Onvif 协议
cameraSetting_gatewaySectionHeaderCfgItem	网关标题
cameraSetting_gatewayCfgItem	网关
cameraSetting_storageSectionHeaderCfgItem	存储设置标题
cameraSetting_storageCfgItem	存储设置
cameraSetting_valueAddedSectionHeaderCfgItem	增值服务标题
cameraSetting_valueAddedCfgItem	增值服务
cameraSetting_offlineSectionHeaderCfgItem	离线提醒标题
cameraSetting_offlineCfgItem	离线提醒
cameraSetting_otherSectionHeaderCfgItem	其他标题
cameraSetting_feedbackCfgItem	常见问题与反馈
cameraSetting_addToHomeCfgItem	添加到桌面
cameraSetting_firmwareCfgItem	设备升级
cameraSetting_restartCfgItem	重启设备
CameraSetting_removeCfgItem	移除设备
CameraSetting_indicatorLightItem	状态指示灯
CameraSetting_besharedItem	设备来自
CameraSetting_soundDetectedItem	声音检测
CameraSetting_apModeItem	热点模式
CameraSetting_unlockItem	远程解锁
CameraSetting_cloudDisk	基站云盘页面
CameraSetting_privacyZone	隐私区域设置
CameraSetting_recording_time	单段录影时间设置
CameraSetting_parking_mode	停车模式设置
CameraSetting_collision_alert	碰撞报警
CameraSetting_antiDismantle	防拆告警开关
CameraSetting_notification	消息推送设置
cameraSetting_carInspection	车型检测开关
cameraSetting_nonCarInspection	非机动检测开关
cameraSetting_thirdPartyHeaderItem	支持的第三方标题
cameraSetting_pirSetItem	PIR 设置
cameraSetting_stationDoorbellItem	基站门铃设置
cameraSetting_stationDetectionItem	基站侦测报警

面板多语言

更多详情，请参考 多语言配置。