日志记录
调试代码或动画流程的一种方法是使用日志消息。为此,motion-canvas 提供了自己内置的消息日志记录方式。
要获取 motion-canvas 中 Logger 的引用,可以使用 useLogger 函数:
import {makeScene2D} from '@motion-canvas/2d';
import {useLogger} from '@motion-canvas/core';
export default makeScene2D(function* (view) {
const logger = useLogger();
// ...
});
基础
既然我们已经知道如何获取 Logger 的引用,下面来看看记录消息的不同方式。一种方式是使用标准的日志函数,如 debug、info、warn 和 error,直接记录一个字符串:
logger.debug('Just here to debug some code.');
logger.info('All fine just a little info.');
logger.warn('Be careful something has gone wrong.');
logger.error('Ups. An error occured.');
这些消息随后会显示在界面左侧的 Console 选项卡下。
载荷
在某些情况下,你可能希望日志消息中包含更详细的信息,例如 stacktrace 或 object。你可以使用载荷为日志消息提供更多信息。
logger.debug({
message: 'Some more advanced logging',
remarks: 'Some remarks about this log. Can also contain <b>HTML</b> tags.',
object: {
someProperty: 'some property value',
},
durationMs: 200,
stack: new Error('').stack,
});
这会在界面中创建一条折叠的日志消息,可将其展开以查看所提供的全部详情。

如果你只是想快速调试某些内容,也可以使用 debug()。这样就不必手动调用 useLogger 并创建载荷。
性能分析
除了记录消息之外,还可以使用 Logger 对某些代码段进行性能分析:
logger.profile('id'); // <-- starts the profiling
// some expensive calculation
logger.profile('id'); // <-- ends the profiling