@rongcloud/plugin-rtc 5.2.4 → 5.2.5

package/dist/core/room/RCAbstractRoom.d.ts

@@ -0,0 +1,351 @@
+import { IJoinRTCRoomData, IReceivedMessage, RTCMode, RTCPluginContext, KVString, IRuntime } from '@rongcloud/engine';
+import { IPublishedResource, IPublishAttrs, IRCRTCReportListener, IRoomEventListener, ISubscribeAttr, IRCRTCInitOptions, IAudioLevelChangeHandler, RoomData } from '../interfaces';
+import { IExchangeReqBody, IRTCReqHeader, RCMediaService } from '../service';
+import RCRTCPeerConnection from '../webrtc/RCRTCPeerConnection';
+import PolarisReporter from '../PolarisReporter';
+import { RCLocalTrack } from '../tracks/RCLocalTrack';
+import { RCRemoteTrack } from '../tracks/RCRemoteTrack';
+import { RCRTCCode } from '../enums/RCRTCCode';
+import { RCLivingType } from '../enums/RCLivingType';
+/**
+ * 房间抽象基类
+ */
+export default abstract class RCAbstractRoom {
+    protected readonly _context: RTCPluginContext;
+    private readonly _runtime;
+    readonly _roomId: string;
+    protected readonly _roomMode: RTCMode;
+    protected readonly _service: RCMediaService;
+    protected readonly _initOptions: IRCRTCInitOptions;
+    private readonly _ntfClearRoomItem;
+    /**
+     * 房间资源数据
+     */
+    protected readonly _roomResources: RoomData;
+    /**
+     * 远端 track
+     */
+    private _remoteTracks;
+    /**
+     * 已订阅参数
+     */
+    private readonly _subscribedList;
+    /**
+     * 房间保活 rtcPing
+     */
+    private readonly _pinger;
+    /**
+     * 与 MediaServer 交互需要的 token 信息
+     */
+    protected readonly _token: string;
+    /**
+     * 每次加入房间后都会改变
+     */
+    private readonly _sessionId;
+    /**
+     * PeerConnection 连接实例
+     */
+    private readonly _pc;
+    private _destroyed;
+    /**
+     * 北极星上报实例
+     */
+    protected _polarisReport: PolarisReporter | null;
+    /**
+     * 音量上报实例
+     */
+    private _audioLevelReport;
+    constructor(_context: RTCPluginContext, _runtime: IRuntime, _roomId: string, data: IJoinRTCRoomData, _roomMode: RTCMode, _service: RCMediaService, _initOptions: IRCRTCInitOptions, _ntfClearRoomItem: Function, isUpgrade?: boolean);
+    private _initRemoteTracks;
+    private _handlePingResult;
+    /**
+     * 设置房间上行资源的总码率配置
+     * @description
+     * * 自 v5.1.0 版本开始，推荐使用 `RCLocalTrack.setBitrate` 对不同流分别指定码率。
+     * * 该方法仅在 SDP `plan-b` 协议下（Chrome 92 与 Safari 11 之前的版本）有效。
+     * @param max 音视频发送码率上限，不可小于 200 且不可小于 `min`
+     * @param min 音视频发送码率下限，默认值为 1，且不可小于 1，不可大于 `max`
+     * @param start 起始码率，默认为码率上限的 70%
+     */
+    setBitrate(max: number, min: number, start?: number): void;
+    private _onTrackReady;
+    protected _callAppListener(eventType: keyof IRoomEventListener, ...attrs: any[]): void;
+    private _onUserUnpublish;
+    private _onTrackUnpublish;
+    private _unpublishPrev;
+    __parseInnerMessage(message: IReceivedMessage): boolean;
+    private msgTaskQueue;
+    /**
+     * 被踢出房间通知
+     * @param byServer
+     * * 当值为 false 时，说明本端 rtcPing 超时
+     * * 当值为 true 时，说明本端收到被踢出房间通知
+     */
+    private _kickoff;
+    private _rtcpeerClosed;
+    /**
+     * 处理资源变更事件
+     * @param content
+     * @param messageType 消息类型
+     * @param userId 消息发送者
+     */
+    protected _resourceHandle(content: {
+        /**
+         * 旧版本兼容参数，当收到非 `RTCMessageName.TOTAL_CONTENT_RESOURCE` 时：
+         * * ignore 值为 `true` 表示该消息由 signal server 向旧版本 RTCLib 提供的兼容消息，无需处理
+         * * 否则认为该消息是由旧版本 RTCLib 主动发出的增量变更消息，需要处理
+         */
+        ignore?: boolean;
+        /**
+         * 发布到房间内的资源列表，`RTCMessageName.TOTAL_CONTENT_RESOURCE` 消息携带全量数据，否则为增量数据
+         */
+        uris: IPublishedResource[];
+    }, messageType: string, userId: string): Promise<void>;
+    private _onTrackPublish;
+    /**
+     * 处理 `RCRTCMessageType.STATE` 消息
+     * @param content
+     */
+    private _stateHandle;
+    /**
+     * 获取房间 Id
+     */
+    getRoomId(): string;
+    /**
+     * 获取当前 userId
+     */
+    getCrtUserId(): string;
+    /**
+     * 获取 _pc 实例
+     */
+    __getPC(): RCRTCPeerConnection;
+    /**
+     * 获取远程用户列表，不包含当前用户
+     */
+    getRemoteUserIds(): string[];
+    /**
+     * 获取所有房间已发布的远端资源列表
+     * @returns
+     */
+    getRemoteTracks(): RCRemoteTrack[];
+    /**
+     * 获取远端用户的资源列表
+     * @param userId
+     * @returns
+     */
+    getRemoteTracksByUserId(userId: string): RCRemoteTrack[];
+    /**
+     * 获取房间当前会话 Id，当房间内已无成员时房间会回收，重新加入时 sessionId 将更新
+     */
+    getSessionId(): string;
+    /**
+     * 向房间内发消息
+     * @param name 消息名称
+     * @param content 消息内容
+     */
+    sendMessage(name: string, content: any): Promise<{
+        code: RCRTCCode;
+    }>;
+    /**
+     * 设置房间属性
+     * @param key 属性名
+     * @param value 属性值
+     * @param message 是否在设置属性的时候携带消息内容，传空则不往房间中发送消息
+     * @param isInner RTC 业务内部使用参数，用户忽略
+     */
+    setRoomAttribute(key: string, value: string, message?: {
+        name: string;
+        content: string;
+    }, isInner?: boolean): Promise<{
+        code: RCRTCCode;
+    }>;
+    /**
+     * 删除房间属性
+     * @param keys 待删除的属性名数组
+     * @param message 是否在删除属性的时候携带消息内容，传空则不往房间中发送消息
+     * @param isInner RTC 业务内部使用参数，用户忽略
+     */
+    deleteRoomAttributes(keys: string[], message?: {
+        name: string;
+        content: string;
+    }, isInner?: boolean): Promise<{
+        code: RCRTCCode;
+    }>;
+    /**
+     * 获取房间属性
+     * @param keys 要查询的属性名数组，当数组长度为空时，取所有已设置的 kv 值
+     * @param isInner RTC 业务内部使用参数，用户忽略
+     */
+    getRoomAttributes(keys?: string[], isInner?: boolean): Promise<{
+        code: RCRTCCode;
+        data?: KVString;
+    }>;
+    /**
+     * 设置当前用户属性（暂不开放）
+     * @param key 属性名
+     * @param value 属性值
+     * @param message 是否在设置属性的时候携带消息内容，传空则不往房间中发送消息
+     */
+    private _setUserAttributeValue;
+    /**
+     * 删除当前用户属性（暂不开放）
+     * @param keys 待删除的属性名数组
+     * @param message 是否在删除属性的时候携带消息内容，传空则不往房间中发送消息
+     */
+    private _deleteUserAttributes;
+    /**
+     * 获取当前用户属性（暂不开放）
+     * @param keys 要查询的属性名数组
+     */
+    private _getUserAttributes;
+    /**
+     * 查询房间是否已销毁
+     */
+    isDestroyed(): boolean;
+    /**
+     * 退出并销毁当前房间实例，退出后该房间的所有方法将不可用
+     */
+    __destroy(quitRoom: boolean): Promise<void>;
+    private _leaveHandle;
+    private _onLocalTrackDestroied;
+    /**
+     * 本端流状态修改，需通知房间内其他成员
+     * @param localTrack
+     */
+    private _onLocalTrackMuted;
+    /**
+     * 发布默认流，默认流的 TAG 为 `RongCloudRTC`，分辨率 640*480，帧率 15 帧
+     * @param pubTiny 是否同步发小流
+     */
+    /**
+     * 从 pc 移除当次发布失败的资源
+     */
+    private _removePubFailedTracks;
+    /**
+     * 增量发布资源，若发布的资源 tag 及媒体类型重复，后者将覆盖前者进行发布。
+     * @param tracks 待发布的 RCLocalTrack 实例
+     * @returns
+     */
+    publish(tracks: (RCLocalTrack | IPublishAttrs)[]): Promise<{
+        code: RCRTCCode;
+        liveUrl?: string;
+    }>;
+    private __publish;
+    /**
+     * ice 断线后，尝试重新走 exchange
+     */
+    protected _reTryExchange(): Promise<void>;
+    protected _exchangeHandle(body: IExchangeReqBody): Promise<{
+        code: RCRTCCode;
+        data?: import("../service").IExchangeResponse | undefined;
+    }>;
+    protected _getRTCReqestHeaders(): IRTCReqHeader;
+    /**
+     * 获取 exchange 接口的请求体数据
+     * @param subscribeList 订阅清单
+     * @param iceRestart
+     */
+    protected _createExchangeParams(subscribeList: ISubscribeAttr[], iceRestart: boolean): Promise<IExchangeReqBody>;
+    /**
+     * 获取已发布资源的 state 数据
+     * @param trackId
+     */
+    private _getResourceState;
+    /**
+     * 增量取消资源发布，若相应资源中存在小流资源，则同时取消发布
+     * @param resourceIds 取消发布的资源 Id 列表
+     */
+    unpublish(tracks: RCLocalTrack[]): Promise<{
+        code: RCRTCCode;
+    }>;
+    private __unpublish;
+    /**
+     * 根据资源 Id 获取资源数据
+     * @param resourceId
+     */
+    private _getResourceById;
+    /**
+     * resourceId 有效性验证
+     * @param resourceId
+     */
+    protected _isValidResourceId(resourceId: string): boolean;
+    /**
+     * 订阅资源
+     * @param tracks
+     */
+    subscribe(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
+    private __subscribe;
+    /**
+     * 取消订阅资源
+     * @param tracks 预取消远端资源
+     */
+    unsubscribe(tracks: RCRemoteTrack[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
+    private __unsubscribe;
+    protected _assertRoomDestroyed(): RCRTCCode | undefined;
+    /**
+     * 获取已发布的本地资源
+     * @param trackId
+     * @returns
+     */
+    getLocalTrack(trackId: string): RCLocalTrack | null;
+    /**
+     * 获取所有已发布的资源
+     */
+    getLocalTracks(): RCLocalTrack[];
+    /**
+     * 根据 trackId 获取房间内的远端资源
+     * @param trackId
+     * @returns
+     */
+    getRemoteTrack(trackId: string): RCRemoteTrack | null;
+    /**
+     * 强制修改订阅列表，仅订阅数组中的资源，取消订阅其他已订阅资源。
+     * 当参数为 `[]` 时，意味着不再订阅任何资源
+     * @param tracks 变更的资源列表
+     */
+    updateSubList(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
+        code: RCRTCCode;
+    }>;
+    private _updateSubListHandle;
+    private _appListener;
+    /**
+     * 注册事件监听器，多次注册会导致后者覆盖前者，可以通过使用 `registerRoomEventListener(null)` 取消注册
+     * @param listener
+     */
+    registerRoomEventListener(listener: IRoomEventListener | null): void;
+    /**
+     * 注册房间数据监控
+     * @param listener
+     * @description 该方法暂仅支持 Chrome 浏览器
+     */
+    registerReportListener(listener: IRCRTCReportListener | null): void;
+    /**
+     * 音量上报
+     * @param handler 业务端传入的音量上报事件
+     * @param gap 上报时间间隔
+     */
+    onAudioLevelChange(handler: IAudioLevelChangeHandler | null, gap?: number): void;
+    /**
+     * 断线重连后尝试补发断线过程中的通知信息
+     */
+    __onReconnected(livingType?: RCLivingType): Promise<{
+        data: IJoinRTCRoomData | undefined;
+    } | void>;
+    private _onAudioMuteChange;
+    private _onVideoMuteChange;
+    /**
+     * 观众切换为主播后直接处理人员变更及资源变更
+     */
+    protected _afterChangedRole(data: IJoinRTCRoomData): void;
+    /**
+     * 销毁远端资源
+     */
+    private _removeRemoteTracks;
+}
+//# sourceMappingURL=RCAbstractRoom.d.ts.map

package/dist/core/room/RCAudienceLivingRoom.d.ts

@@ -0,0 +1,305 @@
+import { RTCPluginContext, IRuntime, IServerRTCRoomEntry } from '@rongcloud/engine';
+import { RCRemoteAudioTrack, RCRemoteTrack, RCRemoteVideoTrack } from '../tracks/RCRemoteTrack';
+import { RCRTCCode } from '../enums/RCRTCCode';
+import { IRCRTCInitOptions, IRCRTCReportListener, IRCRTCTrackEventListener, ISubscribeAttr, IAudioLevelChangeHandler } from '../interfaces';
+import PolarisReporter from '../PolarisReporter';
+import { IBroadcastSubReqBody } from '../service';
+import RCLocalMediaStream from './RCLocalMediaStream';
+import { RCResolution } from '../enums/RCResolution';
+import { RCFrameRate } from '../enums/RCFrameRate';
+import { RCLivingType } from '../enums/RCLivingType';
+import RCRTCPeerConnection from '../webrtc/RCRTCPeerConnection';
+export interface IAudienceRoomEventListener extends IRCRTCTrackEventListener {
+    /**
+     * 主播加入
+     * @param userIds 加入主播的 id 列表
+     */
+    onAnchorJoin?(userId: string[]): void;
+    /**
+     * 主播退出
+     * @param userIds 退出主播的 id 列表
+     */
+    onAnchorLeave?(userId: string[]): void;
+    /**
+     * 房间内合流发布资源
+     * @param tracks 新发布的合流音轨与视轨数据列表，包含新发布的 RCRemoteAudioTrack 与 RCRemoteVideoTrack 实例
+     * @description
+     * 当房间内某个主播第一次发布资源时触发
+     */
+    onTrackPublish?(tracks: RCRemoteTrack[]): void;
+    /**
+     * 房间内取消合流发布资源
+     * @param tracks 被取消发布的合流音轨与视轨数据列表
+     * @description
+     * 当房间内全部主播退出房间时，SDK 内部会取消对资源的订阅，业务层仅需处理 UI 业务
+     */
+    onTrackUnpublish?(tracks: RCRemoteTrack[]): void;
+    /**
+     * 房间内主播发布资源
+     * @param tracks 主播新发布的音轨与视轨数据列表，包含新发布的 RCRemoteAudioTrack 与 RCRemoteVideoTrack 实例
+     */
+    onAnchorTrackPublish?(tracks: RCRemoteTrack[]): void;
+    /**
+     * 房间内主播取消发布资源
+     * @param tracks 被主播取消发布的音轨与视轨数据列表
+     * @description 当资源被取消发布时，SDK 内部会取消对相关资源的订阅，业务层仅需处理 UI 业务
+     */
+    onAnchorTrackUnpublish?(tracks: RCRemoteTrack[]): void;
+    /**
+     * 房间主播禁用/启用音频
+     * @param audioTrack RCRemoteAudioTrack 类实例
+     */
+    onAudioMuteChange?(audioTrack: RCRemoteAudioTrack): void;
+    /**
+    * 房间主播禁用/启用视频
+    * @param videoTrack RCRemoteVideoTrack 类实例对象
+    */
+    onVideoMuteChange?(videoTrack: RCRemoteVideoTrack): void;
+    /**
+     * 房间内主播把发布的资源推至 CDN
+     */
+    onCDNInfoEnable?(CDNInfo: {
+        resolution: RCResolution;
+        fps: RCFrameRate;
+    }): void;
+    /**
+     * 主播停止推 CDN
+     */
+    onCDNInfoDisable?(): void;
+    /**
+     * 主播改变推 CDN 的分辨率或帧率
+     */
+    onCDNInfoChange?(CDNInfo: {
+        resolution: RCResolution;
+        fps: RCFrameRate;
+    }): void;
+}
+/**
+ * 观众直播房间类
+ * 处理：
+ * 1、通知观众房间内 人员变更、资源变更
+ * 2、观众订阅、取消订阅资源
+ */
+export default class RCAudienceLivingRoom {
+    private readonly _context;
+    private readonly _runtime;
+    private readonly _initOptions;
+    readonly _roomId: string;
+    private readonly _joinResData;
+    readonly _livingType: RCLivingType;
+    private readonly _service;
+    /**
+     * 主播列表
+     */
+    private _roomAnchorList;
+    /**
+     * 合流、分流资源
+     */
+    private _roomRes;
+    /**
+     * 主播分流资源
+     */
+    private _roomAnchorRes;
+    /**
+     * 合流、分流 remoteTracks
+     */
+    private _remoteTracks;
+    private _appListener;
+    private _pc;
+    private _subscribedList;
+    private _sessionId;
+    private _destroyed;
+    /**
+     * 北极星上报实例
+     */
+    protected _polarisReport: PolarisReporter | null;
+    /**
+     * 音量上报实例
+     */
+    private _audioLevelReport;
+    /**
+     * cdn_uris 资源
+     */
+    private _CDNUris;
+    constructor(_context: RTCPluginContext, _runtime: IRuntime, _initOptions: IRCRTCInitOptions, _roomId: string, _joinResData: {
+        token: string;
+        kvEntries: IServerRTCRoomEntry[];
+    }, _livingType: RCLivingType);
+    /**
+     * 解析服务端返回的 KV 数据，赋值 room 内数据
+     */
+    private _setInitData;
+    protected _assertRoomDestroyed(): RCRTCCode | undefined;
+    /**
+     * @description 信令数据处理
+     * @param roomId 数据对应的房间 Id
+     * @param singalData 拉取到的数据
+     * * key RC_ANCHOR_LIST value: 为主播 ID 集合
+     * * key RC_RES_`userId` value: 为主播发布的资源
+     * * key RC_RTC_SESSIONID value: sessionId
+     * * key RC_CDN value: CDN 资源数据
+     */
+    private singalDataChange;
+    /**
+     * 计算加入离开的主播 ID 列表
+     */
+    private _diffAnchorList;
+    private _handleNewJoinedAnchor;
+    private _handleLeftedAnchor;
+    /**
+     * 计算新发布和取消发布的合流资源
+     */
+    private _diffRoomResource;
+    /**
+     * 计算主播发布和取消发布的资源，以及资源的状态变更
+    */
+    private _diffAnchorResource;
+    private _onUserUnpublish;
+    private _callAppListener;
+    /**
+     * ice 断线后，尝试重新走 exchange
+    */
+    private _reTryExchange;
+    /**
+     * 获取 subscribe 接口的请求体数据
+     * @param subscribeList 订阅清单
+     * @param publishedStreams 已发布流
+     * @param iceRestart
+     */
+    protected _createSubscribeParams(subscribeList: ISubscribeAttr[], publishedStreams: {
+        [msid: string]: RCLocalMediaStream;
+    }, iceRestart: boolean): Promise<{
+        reqBody: IBroadcastSubReqBody;
+        offer: RTCSessionDescriptionInit;
+        dynamicBitrate: {
+            min: number;
+            max: number;
+        };
+    }>;
+    private _subscribeHandle;
+    private _getReqHeaders;
+    private _exchangeHandle;
+    private _updateSubListHandle;
+    /**
+     * 对比 cdn_uris 资源
+     * @param newCDNUris 新的 cdn_uris 数据
+     */
+    private _diffCDNUris;
+    /**
+     * 获取 CDN 资源对应的拉流地址
+     * _CDNUris 无 url 时，说明未开启 CDN 推送
+     * @returns CDNPlayUrl
+     */
+    private _getCDNPlayUrl;
+    /**
+     * 获取 CDN 资源对应的拉流地址
+     * @returns CDNPlayUrl
+     */
+    getCDNPlayUrl(resolution?: RCResolution, fps?: RCFrameRate): Promise<{
+        code: RCRTCCode;
+        CDNPlayUrl?: string;
+    }>;
+    /**
+     * 订阅资源
+     * @param tracks
+     */
+    subscribe(tracks: (RCRemoteTrack | ISubscribeAttr)[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
+    private __unsubscribe;
+    /**
+     * 取消订阅资源
+     * @param tracks
+     */
+    unsubscribe(tracks: RCRemoteTrack[]): Promise<{
+        code: RCRTCCode;
+        failedList?: ISubscribeAttr[];
+    }>;
+    /**
+     * 退出房间并销毁当前房间实例，退出后该房间的所有方法将不可用
+     */
+    __destroy(quitRoom: boolean): Promise<void>;
+    /**
+     * 根据 trackId 获取房间内的远端资源
+     * @param trackId
+     */
+    getRemoteTrack(trackId: string): RCRemoteTrack;
+    /**
+     * 获取 _pc 实例
+     */
+    __getPC(): RCRTCPeerConnection;
+    /**
+     * TODO 待优化
+     * @param trackId
+     */
+    getLocalTrack(trackId: string): RCRemoteTrack;
+    /**
+     * 断线重连后处理逻辑, SDK 内部处理调用
+     */
+    __onReconnected(): Promise<void>;
+    /**
+     * 观众房间事件注册
+     * @param tag 参数描述
+     */
+    registerRoomEventListener(listener: IAudienceRoomEventListener | null): void;
+    /**
+     * 音量上报
+     * @param handler 业务端传入的音量上报事件
+     * @param gap 上报时间间隔
+     */
+    onAudioLevelChange(handler: IAudioLevelChangeHandler | null, gap?: number): void;
+    /**
+     * 注册房间数据监控
+     * @param listener
+     */
+    registerReportListener(listener: IRCRTCReportListener | null): void;
+    /**
+     * 获取房间 Id
+     */
+    getRoomId(): string;
+    /**
+     * 获取当前 userId
+     */
+    getCrtUserId(): string;
+    /**
+     * 获取房间当前会话 Id，当房间内已无成员时房间会回收，重新加入时 sessionId 将更新
+     */
+    getSessionId(): string;
+    /**
+     * 获取远程主播用户列表
+     */
+    getRemoteUserIds(): string[];
+    /**
+     * 获取远端用户的资源列表
+     * @param userId
+     * @returns
+     */
+    getRemoteTracksByUserId(userId: string): RCRemoteTrack[];
+    /**
+     * 获取房间内所有已发布的远端资源列表, 包含合流资源
+     * @returns
+     */
+    getRemoteTracks(): RCRemoteTrack[];
+    /**
+     * 获取远端 RTC tracks
+     */
+    getRemoteRTCTracks(): RCRemoteTrack[];
+    /**
+     * 获取远端 MCU tracks
+     */
+    getRemoteMCUTracks(): RCRemoteTrack[];
+    /**
+     * 获取房间内 CDN 信息
+     */
+    getCDNInfo(): {
+        resolution: RCResolution;
+        fps: RCFrameRate;
+        CDNEnable: boolean | undefined;
+    } | {
+        CDNEnable: boolean;
+        resolution?: undefined;
+        fps?: undefined;
+    };
+}
+//# sourceMappingURL=RCAudienceLivingRoom.d.ts.map

package/dist/core/room/RCAudioLevelReport.d.ts

@@ -0,0 +1,17 @@
+import { IAudioLevelChangeHandler } from '../interfaces';
+import RCAbstractRoom from './RCAbstractRoom';
+import RCAudienceLivingRoom from './RCAudienceLivingRoom';
+export default class RCAudioLevelReport {
+    private readonly _room;
+    private _pc;
+    private _audioLevelChangeHandler;
+    private _timer;
+    constructor(_room: RCAbstractRoom | RCAudienceLivingRoom);
+    /**
+     * 通知业务端音量 > 0 的数据，数组每一项包含 track、audioLevel
+     */
+    private _audioLevelReport;
+    onAudioLevelChange(handler: IAudioLevelChangeHandler | null, gap: number): void;
+    clearAudioLevelReportTimer(): void;
+}
+//# sourceMappingURL=RCAudioLevelReport.d.ts.map