---
title: IPC 精彩时刻通用方案 - 服务详情设置
summary: IPC 精彩时刻通用方案的服务详情设置模块，包含服务名称、开启状态、关联设备（最多 5 个）、定时拍摄、智能拍摄。依赖 getAlbumSetting（获取配置）、albumSettingSave（首次保存）、albumSettingEdit（二次编辑）三个 API，含数据兜底处理和保存策略区分说明。
---

## 服务详情设置

### 功能介绍

<div style="marginTop: 20px;">
<img alt="原始视频" src="https://images.tuyacn.com/rms-static/c0922a70-2b09-11f0-9f57-5d628208d2a7-1746598133399.png?tyName=ipc_highlights_service_setting.png" width="250">
</div>

1. 精彩时刻服务详情主要包含以下信息：服务名称、服务开启状态、服务关联设备（最多可关联5个设备）、定时拍摄、智能拍摄

2. 精彩时刻服务详情设置，主要依赖以下3个关键能力：

- **获取精彩时刻服务配置信息**  
   开发者可通过 [getAlbumSetting](/cn/miniapp/develop/ray/api/ipc/highlight/timeAlbum/getAlbumSetting) API 获取精彩时刻服务的详细配置信息。

- **保存精彩时刻服务配置信息**  
   首次配置精彩时刻服务信息时，开发者可通过 [albumSettingSave](/cn/miniapp/develop/ray/api/ipc/highlight/timeAlbum/albumSettingSave) API 保存精彩时刻服务的详细配置信息。

- **编辑精彩时刻服务配置信息**  
   首次配置完成后，开发者可通过 [albumSettingEdit](/cn/miniapp/develop/ray/api/ipc/highlight/timeAlbum/albumSettingSave) API 二次编辑精彩时刻服务的详细配置信息。

### 交互流程

```mermaid
sequenceDiagram
    participant 用户
    participant 面板
    participant 云端

    rect rgb(227, 242, 253)
        Note left of 面板: 初始化阶段
        用户 ->> 面板: 首次进入面板
        面板 ->> 云端: getAlbumSetting-api
        云端 -->> 面板: 返回服务详情
        alt 有数据
            面板 ->> 用户: 展示详情数据
        else 无数据
            面板 ->> 用户: 展示兜底数据
        end
    end

    rect rgb(255, 243, 224)
        Note left of 面板: 编辑交互阶段
        loop 实时编辑
            用户 ->> 面板: 修改内容
            面板 ->> 用户: 实时更新展示
        end
    end

    rect rgb(232, 245, 233)
        Note left of 面板: 保存提交阶段
        用户 ->> 面板: 点击保存
        面板 ->> 面板: 判断操作类型
        alt 首次操作
            面板 ->> 云端: albumSettingSave-api
        else 非首次操作
            面板 ->> 云端: albumSettingEdit-api
        end
        云端 ->> 云端: 处理数据修改
        云端 -->> 面板: 返回修改结果
        面板 ->> 用户: 显示操作结果
    end
```

### 注意事项

- 1.**数据兜底处理**
- 必须处理初始化时无数据的场景，返回合理的默认值

  - 建议采用如下兜底策略：

```javascript
    const defaultSettings = {
      // 默认参数配置
    };
```

- 2. **保存策略区分**
     | 操作阶段 | 使用接口 |
     |----------------|--------------------------|
     | 首次初始化 | albumSettingSave-api |
     | 后续更新 | albumSettingEdit-api |