开发你的第一个AE插件

一、环境准备

1.Adobe After Effects 2024
1.1 下载地址： Adobe官网
1.2 模板工程下载：https://developer.adobe.com/console/1367532/user/servicesandapis

若无权限, 可访问 github 获取

2.Microsoft Visual Studio
下载地址：https://visualstudio.microsoft.com/zh-hans/downloads/
配置好c++开发环境后，打开AE模板工程，右键 > 属性
2.1设置插件输出目录到环境变量


2.2设置window调试器目录到环境变量


这是方便所有项目统一配置，另外再设置一下

二、AE模板工程入口文件分析

入口函数EffectMain参数说明

EffectMain(
	PF_Cmd			cmd,
	PF_InData		*in_data,
	PF_OutData		*out_data,
	PF_ParamDef		*params[],
	PF_LayerDef		*output,
	void			*extra)

三、开始开发啦

功能： 在插件的用户界面中添加按钮，点击触发提示用户按钮点击次数

代码实现：
Template/Skeleton/Skeleton.h

...
#define PLUGIN_NAME "Demo"
#define BUTTON_PARAM_ID 1
#define NUM_PARAMS 2 // 包括一个按钮参数和一个结束标记参数

...
typedef struct {
	AEGP_PluginID my_id;
	int click_count; // 记录按钮点击次数
} MyGlobalData;

static MyGlobalData g_my_global_data;

extern "C" {
	DllExport
	PF_Err
	EffectMain(
		PF_Cmd			cmd,
		PF_InData		*in_data,
		PF_OutData		*out_data,
		PF_ParamDef		*params[],
		PF_LayerDef		*output,
		void			*extra);

}
...

Template/Skeleton/Skeleton.cpp

...
static PF_Err 
GlobalSetup (	
	PF_InData		*in_data,
	PF_OutData		*out_data,
	PF_ParamDef		*params[],
	PF_LayerDef		*output )
{
	
	out_data->my_version = PF_VERSION(	MAJOR_VERSION, 
										MINOR_VERSION,
										BUG_VERSION, 
										STAGE_VERSION, 
										BUILD_VERSION);

	out_data->out_flags =  PF_OutFlag_DEEP_COLOR_AWARE;	// just 16bpc, not 32bpc
	
	// 获取插件的 AEGP_PluginID
	AEGP_SuiteHandler suites(in_data->pica_basicP);
	suites.UtilitySuite3()->AEGP_RegisterWithAEGP(NULL, PLUGIN_NAME, &g_my_global_data.my_id);

	g_my_global_data.click_count = 0; // 初始化点击次数

	return PF_Err_NONE;
}

static PF_Err 
ParamsSetup (	
	PF_InData		*in_data,
	PF_OutData		*out_data,
	PF_ParamDef		*params[],
	PF_LayerDef		*output )
{
	PF_Err		err		= PF_Err_NONE;
	PF_ParamDef	def;	

	 // 清除结构体
	AEFX_CLR_STRUCT(def);
	// 定义按钮
	PF_ADD_BUTTON(
		"Click Me",        // PARAM_NAME
		"Click",           // BUTTON_NAME
		0,                 // PUI_FLAGS
		PF_ParamFlag_SUPERVISE, // PARAM_FLAGS
		BUTTON_PARAM_ID    // ID
	);

	// 设置参数数量
	out_data->num_params = NUM_PARAMS;
	
	return err;
}

// 处理按钮点击事件
static PF_Err HandleButtonClick(PF_InData* in_data, PF_OutData* out_data, PF_ParamDef* params[], PF_LayerDef* output) {
	PF_Err err = PF_Err_NONE;
	g_my_global_data.click_count++; // 增加点击次数
	AEGP_SuiteHandler suites(in_data->pica_basicP);
	suites.ANSICallbacksSuite1()->sprintf(out_data->return_msg, "Button clicked %d times!", g_my_global_data.click_count);
	return err;
}

// 插件入口函数
PF_Err
EffectMain(
	PF_Cmd			cmd,
	PF_InData		*in_data,
	PF_OutData		*out_data,
	PF_ParamDef		*params[],
	PF_LayerDef		*output,
	void			*extra)
{
	PF_Err		err = PF_Err_NONE;
	
	try {
		switch (cmd) {
			case PF_Cmd_ABOUT:

				err = About(in_data,
							out_data,
							params,
							output);
				break;
				
			case PF_Cmd_GLOBAL_SETUP:

				err = GlobalSetup(	in_data,
									out_data,
									params,
									output);
				break;
				
			case PF_Cmd_PARAMS_SETUP:

				err = ParamsSetup(	in_data,
									out_data,
									params,
									output);
				break;

			case PF_Cmd_USER_CHANGED_PARAM:
				{
					// 在新的作用域中声明和初始化 extraP
					PF_UserChangedParamExtra* extraP = reinterpret_cast<PF_UserChangedParamExtra*>(extra);
					if (extraP->param_index == BUTTON_PARAM_ID) {
						err = HandleButtonClick(in_data, out_data, params, output);
					}
				}
				break;
				
			case PF_Cmd_RENDER:

				err = Render(	in_data,
								out_data,
								params,
								output);
				break;
			default:            
				break;
		}
	}
	catch(PF_Err &thrown_err){
		err = thrown_err;
	}
	return err;
}
...

四、调试

4.1 点击解决方案 → 生成/重新生成

4.2 点击本地Window调试器，即可启动AE验证调试插件效果

代码错误弹窗提示：

在AE中执行， 编辑>清理>所有[Edit > Purge > All] 命令，它将会清理所有相同特效插件占用的内存，就不用每次都重新启动

这样我们可以成功运行和调试插件，剩下的就是啃API文档~

五、插件安装&使用

将生成的插件文件 .aex 文件复制到 After Effects 插件目录中。默认情况下，插件目录路径如下：
Windows: C:\Program Files\Adobe\Adobe After Effects <版本号>\Support Files\Plug-ins\

如果 After Effects 已经在运行，请关闭并重新启动软件，以便新安装的插件生效

六、AE插件 VS 脚本

小结

• 插件（Plug-ins）：适合高性能、复杂效果和深度集成的需求，但开发难度较高。
• 脚本（Scripts）：适合自动化、批处理和快速开发的需求，开发难度较低。

根据具体需求选择合适的扩展方式，脚本可以满足述求的，用脚本的形式开发更简单些~