给单文件 2048 加「分享成绩」:用 Web Share API 把分数发出去
给单文件 2048 加「分享成绩」:用 Web Share API 把分数发出去
单文件小游戏做到后面,玩家打出了高分,第一反应往往是想发给朋友看看。最省事的办法不是自己做截图、也不是接第三方 SDK,而是用浏览器原生的 Web Share API:navigator.share(),几行代码就能调起系统分享面板,微信、QQ、备忘录都能接住。
先判断支不支持
不是所有浏览器都有这个接口,桌面端 Chrome 有,Safari 移动端有,老浏览器没有。所以调用前先判断,不支持就直接隐藏分享按钮,别让用户点到一个报错的按钮:
const shareBtn = document.getElementById('share-btn');
if (navigator.share) {
shareBtn.hidden = false;
} else {
shareBtn.hidden = true; // 不支持就不显示
}
把判断放在初始化里做一次就行,不用每次点击都判断。
分享的内容怎么写
navigator.share() 接受一个对象,三个字段最常用:title、text、url。对 2048 来说,文案里带上当前分数和最高分就够了,url 填游戏自己的地址,朋友点开就能玩:
async function shareScore(score, best) {
try {
await navigator.share({
title: '2048 小游戏',
text: `我在 2048 里拿到了 ${score} 分,历史最佳 ${best} 分,你来试试?`,
url: location.href,
});
} catch (err) {
// 用户点了取消也会进这里,不是错误,不用弹窗
if (err.name !== 'AbortError') console.warn('分享失败', err);
}
}
注意一个坑:用户在分享面板点取消,Promise 会 reject,错误名是 AbortError。这不是失败,不用弹提示吓用户,只把真正的异常记下来就行。
只能在用户手势里调用
navigator.share() 必须在点击这类真实用户手势里调用,页面加载完自己调是调不起来的。所以把它绑在分享按钮的 click 事件上,不要绑在游戏结束的自动回调里。游戏结束时可以把分享按钮高亮一下,点不点由玩家决定。
不支持的老浏览器怎么办
最简单的兜底是复制链接:navigator.clipboard.writeText() 把带分数的链接写进剪贴板,再提示一句「链接已复制,粘贴发给朋友」。复制 API 同样需要用户手势,同样放在点击回调里,和分享按钮放同一处,逻辑对称:
shareBtn.addEventListener('click', () => {
if (navigator.share) {
shareScore(score, best);
} else {
navigator.clipboard.writeText(location.href);
toast('链接已复制,粘贴发给朋友吧');
}
});
这样写下来,支持分享的手机一点就调起系统面板,不支持的桌面端点一下复制链接,两条路都通。整个功能不到 30 行代码,不引任何依赖,放在单文件 2048 里正合适。
- 点赞
- 收藏
- 关注作者
评论(0)