rvis-aiui-kit 1.2.1 → 1.2.2

package/README.md

@@ -1,6 +1,6 @@
 # rvis-aiui-kit
 
-面向 Rokid AIUI / JSUI 应用的组件库与 Glass3 扩展 SDK。包内包含 7 个 Ink UI 组件、9 组 Host RPC 能力，以及一个 Rokid OpenAPI HTTPS/SSE 客户端。
+面向 Rokid AIUI / JSUI 应用的组件库与 Glass3 扩展 SDK。包内包含 6 个 Ink UI 组件、10 组 Host RPC 能力，以及一个 Rokid OpenAPI HTTPS/SSE 客户端。
 
 ## 文档导航
 
@@ -9,6 +9,7 @@
 - [Glass3 SDK API](#glass3-sdk-api)
   - [API 总览](#api-总览)
   - [Device Context](#device-context)
+  - [Status Bar](#status-bar)
   - [Screen](#screen)
   - [Notification](#notification)
   - [TTS](#tts)
@@ -26,7 +27,6 @@
   - [Markdown](#markdown)
   - [Model List](#model-list)
   - [Paragraph](#paragraph)
-  - [Status Bar](#status-bar)
   - [Table](#table)
 
 ## 安装与运行环境
@@ -64,7 +64,6 @@ npm install rvis-aiui-kit
     }
   },
   "usingComponents": {
-    "rvis-status-bar": "rvis-aiui-kit/status-bar",
     "rvis-paragraph": "rvis-aiui-kit/paragraph",
     "rvis-table": "rvis-aiui-kit/table"
   }
@@ -83,6 +82,11 @@ export default {
     resultText: '准备就绪'
   },
 
+  async onLoad() {
+    await glass3.statusBar.setTitle({ title: '巡检' });
+    await glass3.statusBar.setVisible({ visible: true });
+  },
+
   onMessage(messageEvent) {
     // Host RPC 的 Promise 和流式 onEvent 都依赖这一步。
     glass3.handleMessage(messageEvent);
@@ -108,7 +112,6 @@ export default {
 
 <page>
   <view class="page">
-    <rvis-status-bar title="巡检"></rvis-status-bar>
     <view class="content">
       <rvis-paragraph text="{{ resultText }}" width="424px"></rvis-paragraph>
     </view>
@@ -127,7 +130,7 @@ export default {
 
 .content {
   position: absolute;
-  top: 40px;
+  top: 150px;
   left: 28px;
   width: 424px;
 }
@@ -169,6 +172,7 @@ import glass3, {
 | `deviceContext` | `get(options?)` | 获取设备上下文原子快照 |
 | `deviceContext` | `observe(options?, callOptions?)` | 订阅设备上下文快照和变化 |
 | `deviceContext` | `stopObserve({ requestId })` | 停止设备上下文订阅 |
+| `statusBar` | `setTitle({ title })` / `setVisible({ visible })` | 设置标题并显示 / 隐藏 Native 状态栏 |
 | `screen` | `turnOff()` / `turnOn()` | 息屏 / 亮屏 |
 | `notification` | `show(options)` / `hide({ requestId })` | 显示 / 隐藏原生通知 |
 | `tts` | `speak(options, callOptions?)` / `stop({ requestId })` | TTS 播报 / 停止 |
@@ -217,6 +221,18 @@ await glass3.deviceContext.stopObserve({ requestId: observer.requestId });
 
 `get()` 等待 `snapshot` 事件后完成，返回 `{ requestId, ok, eventType: 'snapshot', snapshot }`。`observe()` 在订阅启动后返回 `{ requestId, ok, state: 'started' }`；首个业务事件为 `snapshot`，后续为 `changed` 或 `invalidated`。SDK 不自动合并 patch。
 
+### Status Bar
+
+```js
+await glass3.statusBar.setTitle({ title: '设备巡检' });
+const result = await glass3.statusBar.setVisible({ visible: true });
+// { updated: true, visible: true }
+```
+
+`title` 必须是字符串，空字符串或全空白字符串用于清理标题；`visible` 必须是 Boolean。建议先设置标题，再显示状态栏。该能力直接解析 Host RPC HTTP response body，不依赖 `onMessage`。
+
+Native 状态栏可能占用屏幕 y=0 到 y=149。全屏页面根节点仍从 y=0 开始，只将页面内容放到 y=150 或更低位置。
+
 ### Screen
 
 ```js
@@ -658,20 +674,6 @@ data: {
 <rvis-paragraph text="{{ text }}" width="424px" segments="{{ segments }}"></rvis-paragraph>
 ```
 
-### Status Bar
-
-注册路径：`rvis-aiui-kit/status-bar`
-
-| 属性 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| `title` | `String` | `''` | 左侧应用标题 |
-
-```html
-<rvis-status-bar title="应用名称"></rvis-status-bar>
-```
-
-组件尺寸固定为 `480px × 20px`，显示应用标题、本地日期时间和实时电量。页面应将其放在全屏绘制区域的 `(0, 0)`。组件自动管理时钟和 `power` 订阅，但 Page 必须把 `onMessage` 转发给共享的 `glass3` 实例。
-
 ### Table
 
 注册路径：`rvis-aiui-kit/table`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rvis-aiui-kit",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "RVIS AIUI components and Glass3 extension SDK.",
   "type": "module",
   "main": "./sdk/index.js",
@@ -18,7 +18,6 @@
       "./markdown": "./components/markdown/index",
       "./model-list": "./components/model-list/index",
       "./paragraph": "./components/paragraph/index",
-      "./status-bar": "./components/status-bar/index",
       "./table": "./components/table/index"
     }
   },

package/sdk/README.md

@@ -226,6 +226,9 @@ const result = await glass3.deviceContext.stopObserve({
 状态栏是 Host 管理的系统 UI，可在屏幕顶部显示标题、时间、网络和电量。该能力只在
 通过 `OPEN_AIX_INK` 外部入口打开的 AIX 页面中注册，页面创建后默认隐藏。
 
+Native 状态栏可能占用屏幕 y=0 到 y=149。页面根节点仍从 y=0 开始，
+只将页面内容放到 y=150 或更低位置。
+
 建议先设置标题，再显示：
 
 ```js

package/sdk/modules/status-bar/readme.md

@@ -7,6 +7,9 @@
 该能力只在通过外部 `OPEN_AIX_INK` 入口打开的 AIX 页面中注册。页面建立后默认隐藏
 状态栏，普通浏览器、普通 WebView 和普通 AI 卡片中调用会失败。
 
+Native 状态栏可能占用屏幕 y=0 到 y=149。保持全屏页面根节点从 y=0
+开始，只把页面内容放到 y=150 或更低位置。
+
 ## API
 
 ### `glass3.statusBar.setTitle({ title })`

package/components/status-bar/index.ink

@@ -1,139 +0,0 @@
-<script def>
-{
-  "component": true
-}
-</script>
-
-<script setup>
-import glass3 from 'rvis-aiui-kit';
-
-function logError(error) {
-  if (error && error.code === 'CALL_DISPOSED') return;
-  console.error('[Status Bar]', error);
-}
-
-export default {
-  properties: {
-    title: {
-      type: String,
-      value: ''
-    }
-  },
-
-  data: {
-    dateText: '',
-    timeText: '',
-    batteryText: '--%',
-    active: false,
-    clockTimer: null,
-    powerObserveRequestId: ''
-  },
-
-  methods: {
-    updateTime() {
-      const now = new Date();
-      const hours = now.getHours();
-      const minutes = now.getMinutes();
-      this.setData({
-        dateText: `${now.getMonth() + 1}/${now.getDate()}`,
-        timeText: `${hours < 10 ? '0' : ''}${hours}:${minutes < 10 ? '0' : ''}${minutes}`
-      });
-    },
-
-    updateBattery(event) {
-      if (!this.data.active) return;
-      if (event.eventType === 'invalidated') {
-        this.data.powerObserveRequestId = '';
-        this.setData({ batteryText: '--%' });
-        return;
-      }
-
-      const power = event.eventType === 'snapshot'
-        ? event.snapshot && event.snapshot.power
-        : event.patch && event.patch.power;
-      if (!power) return;
-
-      this.setData({
-        batteryText: power.levelPercent === undefined
-          ? '--%'
-          : `${power.levelPercent}%`
-      });
-    },
-
-    observePower() {
-      glass3.deviceContext.observe(
-        { domains: ['power'] },
-        { onEvent: event => this.updateBattery(event) }
-      ).then(result => {
-        if (this.data.active) {
-          this.data.powerObserveRequestId = result.requestId;
-          return;
-        }
-
-        glass3.deviceContext.stopObserve({
-          requestId: result.requestId
-        }).catch(logError);
-      }).catch(logError);
-    }
-  },
-
-  lifetimes: {
-    attached() {
-      this.data.active = true;
-      this.updateTime();
-      this.data.clockTimer = setInterval(() => this.updateTime(), 1000);
-      this.observePower();
-    },
-
-    detached() {
-      this.data.active = false;
-
-      if (this.data.clockTimer !== null) {
-        clearInterval(this.data.clockTimer);
-        this.data.clockTimer = null;
-      }
-      if (this.data.powerObserveRequestId) {
-        glass3.deviceContext.stopObserve({
-          requestId: this.data.powerObserveRequestId
-        }).catch(logError);
-        this.data.powerObserveRequestId = '';
-      }
-    }
-  }
-};
-</script>
-
-<page>
-  <view class="status-bar">
-    <text class="status-text">{{ title }}</text>
-    <view class="status-right">
-      <text class="status-text">{{ dateText }}</text>
-      <text class="status-text">{{ timeText }}</text>
-      <text class="status-text">{{ batteryText }}</text>
-    </view>
-  </view>
-</page>
-
-<style>
-.status-bar {
-  display: flex;
-  flex-direction: row;
-  align-items: center;
-  justify-content: space-between;
-  width: 480px;
-  height: 20px;
-}
-
-.status-right {
-  display: flex;
-  flex-direction: row;
-  align-items: center;
-  gap: 10px;
-}
-
-.status-text {
-  color: #40ff5e;
-  font-size: 14px;
-  line-height: 20px;
-}
-</style>

package/components/status-bar/readme.md

@@ -1,45 +0,0 @@
-# Status Bar 组件
-
-标准 Glass3 HUD 状态栏，左侧显示应用标题，右侧显示本地月/日、时间和实时电量。
-
-组件会在 `attached` 时启动时钟和 `power` 订阅，在 `detached` 时清理计时器并停止订阅。
-
-## 注册与使用
-
-```json
-{
-  "usingComponents": {
-    "rvis-status-bar": "rvis-aiui-kit/status-bar"
-  }
-}
-```
-
-```html
-<rvis-status-bar title="应用名称"></rvis-status-bar>
-```
-
-属性：
-
-- `title: String`，默认 `''`，显示在状态栏左侧。
-
-组件固定为 `480px × 20px`，使用 `14px / 20px` 的绿色文本；页面负责将它放在全屏绘制区域的 `(0, 0)`。
-
-## Host 消息转发
-
-Ink 当前只把 Host 消息交给 Page，不会直接调用自定义组件的 `onMessage`。使用该组件的页面必须把消息转发到与组件共享的 `glass3` 单例：
-
-```js
-import glass3 from 'rvis-aiui-kit';
-
-export default {
-  onMessage(messageEvent) {
-    glass3.handleMessage(messageEvent);
-  },
-
-  onUnload() {
-    glass3.dispose();
-  }
-};
-```
-
-除这条 Page 级消息入口外，时间刷新、电量显示、订阅和清理逻辑均由组件管理。电量不可读时显示 `--%`。