升降位置与叶片倾斜可以同时出现在普通窗帘设备门户中,却描述不同的机械关系。前者关注开口被覆盖到什么程度,后者关注百叶片自身的开合姿态。在养老设备资料中保留这种区别,可以让服务人员准确阅读环境设备信息,而不把一个位置值扩张为人员活动或照护结果。
Home Assistant的Cover实体说明把窗帘、遮阳帘、百叶、遮篷、车库门和电动窗等覆盖开口的设备放在这一实体类型中。它们共用部分表示方式,但机械结构并不相同。连续布帘和带可转叶片的百叶,不能只因都被称为窗帘,就预设具有相同功能。
文档中的device class用于说明覆盖物种类,并影响图标、状态措辞及语音助手的称呼。资料卡保留设备类别,可以让读者理解界面中位置一词对应的对象。对于百叶,整体升降与叶片转动可以是两项能力;对于其他覆盖物,可能只有开合或位置能力。
current_cover_position表示当前位置,文档约定从零的关闭端到一百的完全打开端。这里的数字是位置表示,不是电机转速、移动时间或室内亮度。设备资料应把它和原属性名称一起保存,特别是在同一页面还有其他百分数时。
位置值提供比一个打开标签更细的描述。例如覆盖物处于部分打开状态时,仍需要位置背景来说明开口情况。不同设备的物理行程和构造需要对应的集成资料,因此同一个表示范围也不意味着两台设备移动相同的距离。

current_cover_tilt_position专门表示倾斜,范围也是零到一百,但两端含义由文档写成关闭或无倾斜,以及打开或最大倾斜。这个属性不应直接改成角度值;原说明没有把它定义为以度表示的几何角度。
对带叶片的设备,倾斜改变的是叶片姿态,整体覆盖物的位置则是另一关系。资料若只写“位置已调整”,应明确所指属性。叶片能够转动,不等于覆盖物已经升起;整体位置改变,也没有自动给出每片叶片的实际姿态。
实体文档还单列is_opening、is_closing和is_closed,用于形成状态。它按正在打开、正在关闭、是否关闭的顺序解释状态来源,并将OPEN说明为完全或部分打开。这使状态标签和位置属性各有用途:一个概括当前状态,一个保留位置细节。
在设备不移动而关闭状态未知的情况下,文档将实体状态表示为unknown。未知应保留为信息未确定,不能只为让门户看起来整齐,就改成已关闭。这样的说明针对设备状态资料,并不推断房间内是否有人或服务是否完成。

官方Cover详细信息视图设计说明把位置控件描述为高的垂直填充条,填充从顶部向下,完全关闭的百叶对应满条。倾斜则使用第二条带条纹背景的滑条,并以标记表示位置,而不是继续使用同样的填充。
两种图式帮助用户辨认覆盖程度和叶片姿态。界面顶部还可将状态与位置组合显示,在完全打开或关闭时省略重复的位置文字。阅读截图时,保留控件类型及状态行,比把所有可见数字抄进同一位置栏更准确。
文档分别列出普通开合、设置位置、停止,以及倾斜开合、倾斜位置等支持标记。界面依据能力选择滑条、按钮或开关,所以通用设计页展示一种控件,不等于所有设备都具备那项功能。缺少某个滑条也需要联系实体能力和集成背景理解。
设计说明还区分假定状态:集成不能知道真实状态时,界面会以适合该情况的按钮方式呈现。由此可见,控件外观和设备报告应一起阅读。原创配图只解释两种位置角色,没有真实设备值。相关内容见养老环境设备资料栏目及设备文章目录,设备对象和属性名称应随位置说明保留下来。