Skip to main content

changeActorPortrait 改变角色头像

changeActorPortrait​

类型: MethodDeclaration

所属类: CommandFunctionList

定义位置: command.ts

描述​

改变角色头像

参数​

参数名类型描述默认值
\{ actor, mode, portrait, clip, \}{
	actor: [`ActorGetter`](https://github.com/Open-Yami-Community/open-yami-doc/blob/main/i18n/zh/docusaurus-plugin-content-docs/current/script/yami/yami.command.d.ts#L152);
	mode: "full" \| "portrait" \| "clip";
	portrait?: string;
	clip?: [`ImageClip`](https://github.com/Open-Yami-Community/open-yami-doc/blob/main/i18n/zh/docusaurus-plugin-content-docs/current/script/yami/yami.!.d.ts#L23);
} | - | - |

返回值​

类型: CommandFunction

源代码​

位置: 第 7108 行

protected changeActorPortrait({
		actor,
		mode,
		portrait,
		clip,
	}: {
		actor: ActorGetter;
		mode: "full" | "portrait" | "clip";
		portrait?: string;
		clip?: ImageClip;
	}): CommandFunction {
		const getActor = Command.compileActor(actor);
		return () => {
			const actor = getActor();
			if (actor) {
				switch (mode) {
					case "full":
						actor.portrait = portrait!;
						Array.fill(actor.clip, clip!);
						break;
					case "portrait":
						actor.portrait = portrait!;
						break;
					case "clip":
						Array.fill(actor.clip, clip!);
						break;
				}
			}
			return true;
		};
	}

文档生成时间：2026/2/1 16:51:39