【短视频边看边记:小程序无跨App浮层,App补笔记球】
刷短视频或看课程片段时,想随手记一条时间点备注。抖音小程序可以做站内笔记页,但画不出覆盖其他 App 的系统浮层。同一套 uni-app 出 Android App 后,可在 App 端补一个笔记快捷球。插件只支持 Android。详情:https://ext.dcloud.net.cn/plugin?id=29432
【两端分工】
抖音小程序:视频列表、站内笔记页、草稿同步。
Android App:同上,并在用户同意后申请悬浮窗权限,显示笔记球。
【条件编译入口】
—— 代码 ——
// utils/note-ball.js
export function openNoteQuickEntry (clipId) {
return new Promise((resolve) => {
// #ifdef MP-TOUTIAO
uni.navigateTo({
url: '/pages/note/edit?clipId=' + encodeURIComponent(clipId || ''),
success: () => resolve({ platform: 'mp-toutiao', mode: 'in-app-note' }),
fail: (err) => resolve({ platform: 'mp-toutiao', ok: false, err })
})
// #endif
// #ifdef APP-PLUS
showAndroidNoteBall(clipId).then(resolve)
// #endif
})
}
—— 代码结束 ——
【App 端笔记球】
—— 代码 ——
// #ifdef APP-PLUS
import * as floatWin from '@/uni_modules/aiko-float-window'
function showAndroidNoteBall (clipId) {
return new Promise((resolve) => {
floatWin.checkOverlayPermission((res) => {
const ok = res.code === 0 && res.data && res.data.status === true
if (!ok) {
floatWin.toOverlayPermissionPage(() => {})
resolve({ platform: 'app-android', ok: false, reason: 'need-overlay' })
return
}
floatWin.requestPermissions(['android.permission.POST_NOTIFICATIONS'], () => {
floatWin.registerListener((evt) => {
const btn = evt.buttonId || (evt.data && evt.data.buttonId)
if (btn === 'write') {
uni.navigateTo({
url: '/pages/note/edit?clipId=' + encodeURIComponent(clipId || '')
})
}
})
floatWin.show({
mode: 'template',
template: 'video',
id: 'watch-note',
ballText: '笔记',
buttons: [
{ id: 'write', text: '记下' },
{ id: 'list', text: '列表' }
],
notifyTitle: '观看笔记入口',
notifyContent: '可在系统设置关闭悬浮窗',
x: 24,
y: 480
}, (showRes) => {
resolve({ platform: 'app-android', code: showRes.code })
})
})
})
})
}
// #endif
—— 代码结束 ——
不用时 hideById('watch-note');退出登录 hideAll。插件不会自动 show。导入后用自定义基座。常见返回码:0 成功,-2 无悬浮窗权限,-4 当前未显示。
【能力边界】
小程序:站内笔记为主,无系统叠加层浮窗。
Android App:可申请 SYSTEM_ALERT_WINDOW 后显示笔记球;建议同时处理 POST_NOTIFICATIONS。
iOS / 鸿蒙:本插件不支持;APP-PLUS 下的 iOS 勿调用。
展示前说明用途并取得同意;隐私政策需披露会覆盖其他应用。
【插件】
Android全局浮窗(aiko-float-window,市场 ID 29432,作者 Awak3n1ng,普通授权 9.9 元)。仅 App-Android(API 21+)。
详情:
https://ext.dcloud.net.cn/plugin?id=29432
或在 DCloud 插件市场搜「Android全局浮窗」。
