uni-app 中无法直接用 getImageData 提取主色调，小程序/nvue 平台报错或不支持，H5 受 CORS 等限制不可靠；推荐前端降级采样+聚类（如 mini-rgb）或服务端处理。
getImageData 直接提取主色调**，尤其在小程序和 nvue 平台会报错或返回空；H5 虽然技术上可行，但受 CORS、本地 file 路径、跨域限制，实际几乎不可靠。真正能落地的只有两种路径：**前端降级采样 + 聚类**（需绕过 getImageData），或**服务端处理**（推荐）。
小程序平台必须先 downloadFile 再 canvasToTempFilePath
小程序 Canvas 不暴露像素数据，uni.canvasGetImageData 在 iOS 和部分安卓版本直接失效。你得走“下载 → 获取尺寸 → 缩放绘制 → base64 解析”这一套链路：
- 传入的必须是网络图直链？不行，先调
uni.downloadFile拿到tempFilePath，否则 iOS 小程序拒绝绘制 -
uni.getImageInfo必须等 download 完成后再调，否则宽高为 0，缩放失真 - canvas 绘制时建议固定缩放到 64×64 或 128×128，太大导致采样慢、内存溢出（尤其低端机）
- 别自己用
toDataURL解 base64——mini-rgb 库内部已封装好该逻辑，且做了平台判断（自动跳过 nvue）
H5 平台看似可用 getImageData，但坑比功能多
H5 确实支持 canvas.getContext('2d').getImageData，但前提是图片资源满足 CORS 要求：
- 本地
file://路径绝对不行，浏览器直接拦截 - 跨域图必须服务端响应头带
Access-Control-Allow-Origin: *，否则getImageData抛 SecurityError - 即使同域，某些 CDN 或图床（如微信公众号图）默认不配 CORS，你控制不了
- 就算成功，全图逐像素读取在大图（>2MB）下卡顿明显，用户感知差
nvue（App-vue）完全不支持 getImageData，别试了
nvue 渲染层基于原生控件，Canvas 是封装过的轻量实现，getContext('2d') 返回的对象没有 getImageData 方法，调用即报 undefined is not a function。官方文档也明确标注「不支持像素级操作」。
- 想在 App 里做主色提取？只能走原生插件（如 Android/iOS 分别调用 Palette / UIImageAsset API），或彻底放弃前端方案
- 有人尝试用 web-view 嵌 H5 页面来绕过，但体验割裂、通信成本高，不推荐
- 如果你项目已接入原生能力，优先考虑把图片路径传给原生模块，由它返回 RGB 数组
mini-rgb 是目前最稳的前端方案，但要注意初始化时机
mini-rgb 不依赖 getImageData，而是通过 canvasToTempFilePath 渲染缩略图后解析 base64 数据，再用优化版 k-means 聚类。但它不是“拿来就用”：
- 安装后必须配合
uni.getSystemInfoSync().platform判断平台，nvue 下要提前 return，否则报错 - 调用前确保图片已加载完成——
@load触发后再执行，否则 canvas 绘制为空白，结果全是 #ffffff - 参数
quality: 10可提速，但聚类精度下降；colorCount: 5能多返回几个候选色，方便做明暗适配 - 别传
https://xxx.com/xx.jpg直链，一定要传tempFilePath，这是 mini-rgb 内部读取文件的前提
