`asset.loadFont()`

验证并注册 manifest 声明的包内字体，返回只能用于宿主文本渲染接口的类型化句柄。

Syntax

const font = await host.asset.loadFont(assetId);

Parameters

assetId: string：指向 v0.1 支持字体格式的 manifest 资源 ID。

Return value

Handle<font, use, app-context, runtime>

句柄不可序列化、跨应用复用或当作字体字节读取。

Examples

const font = await host.asset.loadFont('fonts/ui');
const [title] = await host.canvas.measureText('main', ['欢迎'], font);
await host.canvas.draw('main', [
  { op: 'fillText', text: '欢迎', x: 24, y: 48, font, color: '#ffffff' },
]);

Errors

not-found、invalid-format、unsupported-format、limit-exceeded。宿主在交给字体后端前执行大小、魔数和结构校验。

Requirements

能力：host:asset.loadFont
用户激活：不需要
句柄生命周期：runtime
信任档位：green

asset.loadFont()