如何通过ExtendScript获取After Effects图层所有帧的像素数据

ExtendScript 原生Layer对象未直接暴露帧像素读取接口，要实现逐帧像素遍历对比，核心逻辑是逐帧定位时间点，将目标图层当前帧输出为可解析的位图数据后读取RGBA值，以下是两种可落地的实现路径：

方案1：渲染队列输出临时文件（全版本兼容，稳定性最高） #

这是适配所有AE版本的通用方案，步骤如下：

• 提前缓存目标合成、目标图层的初始状态：包括合成当前时间指针位置、合成内所有图层的可见性开关状态，处理完成后还原，避免破坏用户工程状态
• 逐帧移动合成时间指针到对应帧位置，定位代码为comp.time = 当前帧序号 * comp.frameDuration
• 临时隐藏合成内除目标图层外的所有图层，排除其他图层对输出像素的干扰
• 调用渲染队列将当前帧输出为无压缩PNG格式文件到系统临时目录，输出完成后读取该文件的二进制数据解析RGBA像素值
• 单帧像素读取、对比完成后删除临时文件，所有帧处理完毕后还原工程初始状态

核心逻辑参考代码：

// 传入已选中的目标图层
function processLayerFrames(targetLayer) {
    const comp = targetLayer.containingComp;
    const totalFrames = Math.round(comp.duration / comp.frameDuration);
    const frameDuration = comp.frameDuration;
    // 缓存初始状态
    const originalTime = comp.time;
    const originalSuppressDialogs = app.suppressDialogs;
    const originalAutoUpdate = app.project.disableAutoUpdate;
    const layerVisibility = [];

    // 关闭弹窗和自动刷新提升速度
    app.suppressDialogs = true;
    app.project.disableAutoUpdate = true;

    // 缓存所有图层可见性，仅保留目标图层可见
    for (let i = 1; i <= comp.layers.length; i++) {
        layerVisibility.push(comp.layers[i].enabled);
        comp.layers[i].enabled = false;
    }
    targetLayer.enabled = true;

    // 逐帧处理
    for (let frameIdx = 0; frameIdx < totalFrames; frameIdx++) {
        comp.time = frameIdx * frameDuration;
        // 此处添加：渲染当前帧到临时PNG、解析像素、执行帧对比的逻辑
    }

    // 还原所有初始状态
    for (let i = 1; i <= comp.layers.length; i++) {
        comp.layers[i].enabled = layerVisibility[i-1];
    }
    comp.time = originalTime;
    app.suppressDialogs = originalSuppressDialogs;
    app.project.disableAutoUpdate = originalAutoUpdate;
}

方案2：内存渲染接口（CC2019及以上版本支持，无临时文件） #

AE CC2019及后续版本新增了合成内存渲染接口，不需要写临时文件，可以直接将当前帧输出为内存中的位图对象，配合CEP扩展面板的Node.js环境可以直接解析像素数据，处理速度比临时文件方案高30%以上，适合帧数量大的对比场景。

注意事项

• 脚本运行时建议关闭合成实时预览，通过app.project.disableAutoUpdate = true禁止界面自动刷新，能大幅提升逐帧跳转的处理速度
• 纯ExtendScript环境解析二进制位图效率极低，如果处理时长超过100帧的素材，建议搭配CEP面板使用Node.js的位图解析库处理像素数据，效率是纯ExtendScript的数十倍
• 如果目标图层关联了3D图层、调整图层、轨道蒙版等依赖其他图层的效果，不要直接隐藏其他图层，改为临时新建一个同尺寸的空合成，把目标图层复制到空合成中再渲染，避免效果丢失

内容的提问来源于stack exchange，提问作者Marian