前端:/local 页支持「叫醒」已安装的本机软件(自定义协议 + 轮询探活)

网页没法直接执行 exe,只能走「自定义 URL Scheme」(百度云盘 baiduyunguanjia://、迅雷
thunder:// 都是这个套路):浏览器让系统按注册表里的协议去拉起应用。

- api/local.ts 新增 APP_PROTOCOL(VITE_APP_PROTOCOL,默认 yuncang)、appLaunchUrl()、
  launchApp()(隐藏 iframe 触发,避免协议没注册时整页报错)、waitForHealth()(1s 一次,
  默认最多等 12s)。
- 离线态多一个「已安装,启动本机软件」按钮:点完进 launching 态,轮询 health;
  起来了就自动查询原来的 code;12s 还没起来则提示「可能没安装 / 没注册启动协议」,
  并保留下载按钮。
- 下载按钮、探活提示与居中布局保持不变。

实测(7301 + 模拟的 17311):先打开显示「服务暂不可用」;点启动后进入「正在启动本机软件…」,
轮询期间把模拟服务起起来,页面自动切到查询结果(4 行)。
This commit is contained in:
liufumingren 2026-10-17 10:06:08 +08:00
parent 7198dd1eb4
commit 9be56db385
2 changed files with 86 additions and 5 deletions

View File

@ -77,3 +77,45 @@ export async function checkLocalHealth(): Promise<boolean> {
export function queryLocalInfo(code: string): Promise<unknown> {
return get<unknown>(`/api/query/${encodeURIComponent(code)}`, 8000);
}
/**
* 叫醒已安装的本机软件:**自定义 URL Scheme**(安装包写进注册表的那种,像 `thunder://`、
* `baiduyunguanjia://` 一样)
*
* 网页**无法直接执行 exe**:只能让浏览器去打开 `xxx://…`,由系统按注册表找到 exe 并拉起(
* Chrome/Edge 会先弹「要打开 xxx 吗?」)。所以:先试这个,再轮询 health 确认真的起来了。
*
* 协议名用 `VITE_APP_PROTOCOL` 配(默认 `yuncang`),必须与安装包里注册的一致。
*/
export const APP_PROTOCOL = (import.meta.env.VITE_APP_PROTOCOL as string | undefined) || 'yuncang';
/** 拼出唤醒地址(把 code 一并带过去,软件起来后可以直接定位到该运单) */
export function appLaunchUrl(code?: string): string {
const query = code ? `?code=${encodeURIComponent(code)}` : '';
return `${APP_PROTOCOL}://open${query}`;
}
/**
* 触发唤醒。用隐藏 iframe 而不是 `location.href`:
* 协议没注册时 Chrome 会直接在当前标签报错页,用 iframe 就只是静默失败。
*/
export function launchApp(code?: string): void {
const iframe = document.createElement('iframe');
iframe.style.display = 'none';
iframe.src = appLaunchUrl(code);
document.body.appendChild(iframe);
setTimeout(() => iframe.remove(), 1500);
}
/**
* 轮询探活:本机软件从被叫醒到 HTTP 服务可用需要几秒
* @return 超时前探到返回 true,否则 false
*/
export async function waitForHealth(timeoutMs = 12000, intervalMs = 1000): Promise<boolean> {
const deadline = Date.now() + timeoutMs;
while (Date.now() < deadline) {
if (await checkLocalHealth()) return true;
await new Promise(resolve => setTimeout(resolve, intervalMs));
}
return false;
}

View File

@ -12,7 +12,15 @@
*/
import { computed, onMounted, ref } from 'vue';
import { useRoute, useRouter } from 'vue-router';
import { checkLocalHealth, queryLocalInfo, LOCAL_BASE, LocalServiceError } from '@/api/local';
import {
APP_PROTOCOL,
checkLocalHealth,
launchApp,
queryLocalInfo,
waitForHealth,
LOCAL_BASE,
LocalServiceError,
} from '@/api/local';
/**
* 安装包下载地址:换成真实地址,或用环境变量 `VITE_SOFTWARE_DOWNLOAD_URL` 覆盖
@ -23,23 +31,45 @@ const DOWNLOAD_URL = (import.meta.env.VITE_SOFTWARE_DOWNLOAD_URL as string | und
const route = useRoute();
const router = useRouter();
type Status = 'checking' | 'offline' | 'ready';
type Status = 'checking' | 'offline' | 'launching' | 'ready';
const status = ref<Status>('checking');
const code = ref(String(route.query.code || '').trim());
const info = ref<unknown>(null);
const querying = ref(false);
const error = ref('');
const launchFailed = ref(false);
/** 探活:连不上就是「软件没启动」 */
async function detect() {
status.value = 'checking';
error.value = '';
launchFailed.value = false;
const alive = await checkLocalHealth();
status.value = alive ? 'ready' : 'offline';
if (alive) await runQuery();
}
/**
* 「启动本机软件」:用自定义协议叫醒(浏览器会问一次),再轮询探活
*
* 网页不能直接跑 exe —— 只能让系统按注册的协议去拉起(百度云盘/迅雷就是这个路子)。
*/
async function launch() {
launchFailed.value = false;
status.value = 'launching';
launchApp(code.value.trim() || undefined);
const alive = await waitForHealth();
if (alive) {
status.value = 'ready';
await runQuery();
return;
}
launchFailed.value = true;
status.value = 'offline';
}
/** 按码查信息(没填码就只停在输入框) */
async function runQuery() {
const target = code.value.trim();
@ -91,10 +121,14 @@ onMounted(detect);
<div class="card bare-card local-card">
<div class="brand-line">云仓视频溯源系统</div>
<!-- ① 正在检测 -->
<!-- ① 正在检测 / 正在启动 -->
<template v-if="status === 'checking'">
<p class="center hint">正在检测本机打印服务…</p>
</template>
<template v-else-if="status === 'launching'">
<p class="center hint">正在启动本机软件…(浏览器问“要打开吗”请点允许)</p>
<p class="center hint tiny">等它启动完成后本页会自动继续</p>
</template>
<!-- ② 本机软件没启动 / 连不上 -->
<template v-else-if="status === 'offline'">
@ -105,9 +139,14 @@ onMounted(detect);
<p class="center">
<a class="btn download" :href="DOWNLOAD_URL" target="_blank" rel="noopener">下载 云仓视频溯源软件</a>
</p>
<p class="center">
<button class="btn btn-ghost" type="button" @click="launch">已安装,启动本机软件</button>
</p>
<p v-if="launchFailed" class="center hint tiny">
没有反应?可能是没安装、或安装时没注册启动协议({{ APP_PROTOCOL }}://),先下载安装吧。
</p>
<p class="center hint tiny">
已安装?请先启动软件,再点
<a href="#" @click.prevent="detect">重新检测</a>
再点 <a href="#" @click.prevent="detect">重新检测</a>
<br>
(当前探测地址:{{ LOCAL_BASE }})
</p>