Class TilemapLoader

packages/tilemap/src/loaders/TilemapLoader.ts:54–93

 * 瓦片地图加载器实现
 */
export class TilemapLoader implements IAssetLoader<ITilemapAsset> {
    readonly supportedType = TilemapAssetType;
    readonly supportedExtensions = ['.tilemap.json', '.tilemap'];
    readonly contentType: AssetContentType = 'text';

    /**
     * Parse tilemap asset from text content
     * 从文本内容解析瓦片地图资产
     */
    async parse(content: IAssetContent, _context: IAssetParseContext): Promise<ITilemapAsset> {
        if (!content.text) {
            throw new Error('Tilemap content is empty');
        }

        const jsonData = JSON.parse(content.text) as ITilemapAsset;

        // 验证必要字段
        // Validate required fields
        if (!jsonData.width || !jsonData.height || !jsonData.data) {
            throw new Error('Invalid tilemap format: missing required fields');
        }

        return jsonData;
    }

    /**
     * Dispose loaded asset
     * 释放已加载的资产
     */
    dispose(asset: ITilemapAsset): void {
        // 清理瓦片数据 | Clean up tile data
        asset.data.length = 0;
        if (asset.layers) {
            asset.layers.length = 0;
        }
        if (asset.collisionData) {
            asset.collisionData.length = 0;
        }
    }
}