david_bai
504 lines
16 KiB
TypeScript
504 lines
16 KiB
TypeScript
// Flow for sending file(s)/folder(s): First, send file metadata, wait for the receiver's request, then send the file content.
|
|
// After the file is sent, send an endMeta, wait for the receiver's ack, and finish.
|
|
// Flow for sending a folder (same as above): Receive a batch file request.
|
|
// Loop through and send the metadata for all files, then record the file size information for the folder part to calculate progress.
|
|
// The receiving display end distinguishes between single files and folders.
|
|
import { generateFileId } from "@/lib/fileUtils";
|
|
import { SpeedCalculator } from "@/lib/speedCalculator";
|
|
import WebRTC_Initiator from "./webrtc_Initiator";
|
|
import {
|
|
CustomFile,
|
|
fileMetadata,
|
|
WebRTCMessage,
|
|
PeerState,
|
|
FolderMeta,
|
|
FileAck,
|
|
FileRequest,
|
|
FolderComplete,
|
|
} from "@/types/webrtc";
|
|
|
|
class FileSender {
|
|
private webrtcConnection: WebRTC_Initiator;
|
|
private peerStates: Map<string, PeerState>;
|
|
private readonly chunkSize: number;
|
|
private readonly maxBufferSize: number;
|
|
private pendingFiles: Map<string, CustomFile>;
|
|
private pendingFolerMeta: Record<string, FolderMeta>;
|
|
private speedCalculator: SpeedCalculator;
|
|
|
|
// 统一优化配置 - 适用于所有设备的最佳参数
|
|
private static readonly OPTIMIZED_CONFIG = {
|
|
CHUNK_SIZE: 262144, // 256KB - 最优块大小，减少I/O调用
|
|
BATCH_SIZE: 12, // 12块批量 - 充分利用内存和网络
|
|
BUFFER_THRESHOLD: 1572864, // 1.5MB - 最大化网络利用率
|
|
MAX_BUFFER_SIZE: 5, // 5块预读缓冲
|
|
BACKPRESSURE_TIMEOUT: 1000, // 1秒超时
|
|
} as const;
|
|
|
|
constructor(WebRTC_initiator: WebRTC_Initiator) {
|
|
this.webrtcConnection = WebRTC_initiator;
|
|
|
|
// Maintain independent sending states for each receiver
|
|
this.peerStates = new Map(); // Map<peerId, PeerState>
|
|
|
|
// 统一使用优化参数 - 所有设备共享最佳配置
|
|
this.chunkSize = FileSender.OPTIMIZED_CONFIG.CHUNK_SIZE;
|
|
this.maxBufferSize = FileSender.OPTIMIZED_CONFIG.MAX_BUFFER_SIZE;
|
|
this.pendingFiles = new Map(); // All files pending to be sent (by reference) {fileId: CustomFile}
|
|
|
|
this.pendingFolerMeta = {}; // Metadata for folders (total size, total file count), used for tracking transfer progress
|
|
|
|
// Create a SpeedCalculator instance
|
|
this.speedCalculator = new SpeedCalculator();
|
|
this.setupDataHandler();
|
|
}
|
|
|
|
// region Logging and Error Handling
|
|
private log(
|
|
level: "log" | "warn" | "error",
|
|
message: string,
|
|
context?: Record<string, any>
|
|
) {
|
|
const prefix = `[FileSender]`;
|
|
console[level](prefix, message, context || "");
|
|
}
|
|
|
|
private fireError(message: string, context?: Record<string, any>) {
|
|
this.webrtcConnection.fireError(message, {
|
|
...context,
|
|
component: "FileSender",
|
|
});
|
|
}
|
|
// endregion
|
|
// Initialize state for a new receiver
|
|
private getPeerState(peerId: string): PeerState {
|
|
if (!this.peerStates.has(peerId)) {
|
|
this.peerStates.set(peerId, {
|
|
isSending: false, // Used to determine if a file is successfully sent. True before sending, false after receiving ack.
|
|
bufferQueue: [], // Pre-read buffer to improve sending efficiency.
|
|
readOffset: 0, // Read position, used by the sending function.
|
|
isReading: false, // Whether reading is in progress, used by the sending function to avoid duplicate reads.
|
|
|
|
currentFolderName: "", // If the current file belongs to a folder, assign the folder name here.
|
|
totalBytesSent: {}, // Bytes sent for a file/folder, used for progress calculation; {fileId: 0}
|
|
progressCallback: null, // Progress callback.
|
|
});
|
|
}
|
|
return this.peerStates.get(peerId)!; // ! Non-Null Assertion Operator
|
|
}
|
|
|
|
private setupDataHandler(): void {
|
|
this.webrtcConnection.onDataReceived = (data, peerId) => {
|
|
if (typeof data === "string") {
|
|
try {
|
|
const parsedData = JSON.parse(data) as WebRTCMessage;
|
|
this.handleSignalingMessage(parsedData, peerId);
|
|
} catch (error) {
|
|
this.fireError("Error parsing received JSON data", { error, peerId });
|
|
}
|
|
}
|
|
};
|
|
}
|
|
|
|
private handleSignalingMessage(message: WebRTCMessage, peerId: string): void {
|
|
const peerState = this.getPeerState(peerId);
|
|
switch (message.type) {
|
|
case "fileRequest":
|
|
this.handleFileRequest(message as FileRequest, peerId);
|
|
break;
|
|
case "fileAck":
|
|
peerState.isSending = false;
|
|
this.log("log", `Received file-finish ack from peer ${peerId}`, {
|
|
fileId: (message as FileAck).fileId,
|
|
});
|
|
break;
|
|
case "folderComplete":
|
|
const folderName = (message as FolderComplete).folderName;
|
|
this.log(
|
|
"log",
|
|
`Received folderComplete message for ${folderName} from peer ${peerId}`
|
|
);
|
|
// The receiver has confirmed the folder is complete.
|
|
// Force the progress to 100% for the sender's UI.
|
|
if (this.pendingFolerMeta[folderName]) {
|
|
peerState.progressCallback?.(folderName, 1, 0);
|
|
}
|
|
break;
|
|
default:
|
|
this.log("warn", `Unknown signaling message type received`, {
|
|
type: message.type,
|
|
peerId,
|
|
});
|
|
}
|
|
}
|
|
|
|
public setProgressCallback(
|
|
callback: (fileId: string, progress: number, speed: number) => void,
|
|
peerId: string
|
|
): void {
|
|
this.getPeerState(peerId).progressCallback = callback;
|
|
}
|
|
// Respond to a file request by sending the file
|
|
private async handleFileRequest(
|
|
request: FileRequest,
|
|
peerId: string
|
|
): Promise<void> {
|
|
const file = this.pendingFiles.get(request.fileId);
|
|
const offset = request.offset || 0;
|
|
this.log(
|
|
"log",
|
|
`Handling file request for ${request.fileId} from ${peerId} with offset ${offset}`
|
|
);
|
|
if (file) {
|
|
await this.sendSingleFile(file, peerId, offset);
|
|
} else {
|
|
this.fireError(`File not found for request`, {
|
|
fileId: request.fileId,
|
|
peerId,
|
|
});
|
|
}
|
|
}
|
|
// Modify the sendString method to be asynchronous
|
|
public async sendString(content: string, peerId: string): Promise<void> {
|
|
const chunks: string[] = [];
|
|
for (let i = 0; i < content.length; i += this.chunkSize) {
|
|
chunks.push(content.slice(i, i + this.chunkSize));
|
|
}
|
|
|
|
// First, send the metadata
|
|
await this.sendWithBackpressure(
|
|
JSON.stringify({
|
|
type: "stringMetadata",
|
|
length: content.length,
|
|
}),
|
|
peerId
|
|
);
|
|
|
|
// Send each chunk sequentially, using backpressure control
|
|
for (let i = 0; i < chunks.length; i++) {
|
|
const data = JSON.stringify({
|
|
type: "string",
|
|
chunk: chunks[i],
|
|
index: i,
|
|
total: chunks.length,
|
|
});
|
|
await this.sendWithBackpressure(data, peerId);
|
|
}
|
|
}
|
|
|
|
public sendFileMeta(files: CustomFile[], peerId?: string): void {
|
|
// Record the size of files belonging to a folder for progress calculation
|
|
files.forEach((file) => {
|
|
if (file.folderName) {
|
|
const folderId = file.folderName;
|
|
// folderName: {totalSize: 0, fileIds: []}
|
|
if (!this.pendingFolerMeta[folderId]) {
|
|
this.pendingFolerMeta[folderId] = { totalSize: 0, fileIds: [] };
|
|
}
|
|
const folderMeta = this.pendingFolerMeta[folderId];
|
|
const fileId = generateFileId(file);
|
|
if (!folderMeta.fileIds.includes(fileId)) {
|
|
// If the file has not been added yet
|
|
folderMeta.fileIds.push(fileId);
|
|
folderMeta.totalSize += file.size;
|
|
}
|
|
}
|
|
});
|
|
// Loop through and send the metadata for all files
|
|
const peers = peerId
|
|
? [peerId]
|
|
: Array.from(this.webrtcConnection.peerConnections.keys());
|
|
peers.forEach((pId) => {
|
|
files.forEach((file) => {
|
|
const fileId = generateFileId(file);
|
|
this.pendingFiles.set(fileId, file);
|
|
const fileMeta = this.getFileMeta(file);
|
|
const metaDataString = JSON.stringify(fileMeta);
|
|
|
|
const sendResult = this.webrtcConnection.sendData(metaDataString, pId);
|
|
if (!sendResult) {
|
|
this.fireError("Failed to send file metadata", {
|
|
fileMeta,
|
|
peerId: pId,
|
|
});
|
|
}
|
|
});
|
|
});
|
|
}
|
|
|
|
// Send a single file
|
|
private async sendSingleFile(
|
|
file: CustomFile,
|
|
peerId: string,
|
|
offset: number = 0
|
|
): Promise<void> {
|
|
const fileId = generateFileId(file);
|
|
const peerState = this.getPeerState(peerId);
|
|
|
|
if (peerState.isSending) {
|
|
return;
|
|
}
|
|
|
|
// Reset state for the new transfer
|
|
peerState.isSending = true;
|
|
peerState.currentFolderName = file.folderName;
|
|
peerState.readOffset = offset; // Start reading from the given offset
|
|
peerState.bufferQueue = [];
|
|
peerState.isReading = false;
|
|
peerState.totalBytesSent[fileId] = offset; // Start counting sent bytes from the offset
|
|
|
|
try {
|
|
await this.processSendQueue(file, peerId);
|
|
this.finalizeSendFile(fileId, peerId);
|
|
|
|
await this.waitForTransferComplete(peerId); // Wait for transfer completion -- receiver confirmation
|
|
} catch (error: any) {
|
|
this.fireError(`Error sending file ${file.name}: ${error.message}`, {
|
|
fileId,
|
|
peerId,
|
|
});
|
|
this.abortFileSend(fileId, peerId);
|
|
}
|
|
}
|
|
|
|
private async waitForTransferComplete(peerId: string): Promise<void> {
|
|
const peerState = this.getPeerState(peerId);
|
|
while (peerState?.isSending) {
|
|
await new Promise((resolve) => setTimeout(resolve, 50));
|
|
}
|
|
}
|
|
private getFileMeta(file: CustomFile): fileMetadata {
|
|
const fileId = generateFileId(file);
|
|
return {
|
|
type: "fileMeta",
|
|
fileId,
|
|
name: file.name,
|
|
size: file.size,
|
|
fileType: file.type,
|
|
fullName: file.fullName,
|
|
folderName: file.folderName,
|
|
};
|
|
}
|
|
|
|
private async updateProgress(
|
|
byteLength: number,
|
|
fileId: string,
|
|
fileSize: number,
|
|
peerId: string
|
|
): Promise<void> {
|
|
const peerState = this.getPeerState(peerId);
|
|
if (!peerState) return;
|
|
|
|
// Always update the individual file's progress first.
|
|
if (!peerState.totalBytesSent[fileId]) {
|
|
// This case should be handled by sendSingleFile's initialization
|
|
peerState.totalBytesSent[fileId] = 0;
|
|
}
|
|
peerState.totalBytesSent[fileId] += byteLength;
|
|
|
|
let progressFileId = fileId;
|
|
let currentBytes = peerState.totalBytesSent[fileId];
|
|
let totalSize = fileSize;
|
|
|
|
// If the file is part of a folder, recalculate the folder's progress.
|
|
if (peerState.currentFolderName) {
|
|
const folderId = peerState.currentFolderName;
|
|
const folderMeta = this.pendingFolerMeta[folderId];
|
|
progressFileId = folderId;
|
|
totalSize = folderMeta?.totalSize || 0;
|
|
|
|
// Recalculate folder progress from the sum of its files' progresses.
|
|
// This is more robust and correct for resumed transfers.
|
|
let folderTotalSent = 0;
|
|
if (folderMeta) {
|
|
folderMeta.fileIds.forEach((fId) => {
|
|
folderTotalSent += peerState.totalBytesSent[fId] || 0;
|
|
});
|
|
}
|
|
currentBytes = folderTotalSent;
|
|
}
|
|
|
|
this.speedCalculator.updateSendSpeed(peerId, currentBytes);
|
|
const speed = this.speedCalculator.getSendSpeed(peerId);
|
|
const progress = totalSize > 0 ? currentBytes / totalSize : 0;
|
|
|
|
peerState.progressCallback?.(progressFileId, progress, speed);
|
|
}
|
|
|
|
private async sendWithBackpressure(
|
|
data: string | ArrayBuffer,
|
|
peerId: string
|
|
): Promise<void> {
|
|
const dataChannel = this.webrtcConnection.dataChannels.get(peerId);
|
|
if (!dataChannel) {
|
|
throw new Error("Data channel not found");
|
|
}
|
|
|
|
// 统一使用优化的缓冲区阈值
|
|
const threshold = FileSender.OPTIMIZED_CONFIG.BUFFER_THRESHOLD;
|
|
|
|
// 检查是否需要等待背压缓解
|
|
if (dataChannel.bufferedAmount > threshold) {
|
|
await new Promise<void>((resolve) => {
|
|
const onBufferedAmountLow = () => {
|
|
dataChannel.removeEventListener(
|
|
"bufferedamountlow",
|
|
onBufferedAmountLow
|
|
);
|
|
resolve();
|
|
};
|
|
dataChannel.addEventListener("bufferedamountlow", onBufferedAmountLow);
|
|
|
|
// 设置超时以避免永久等待
|
|
setTimeout(() => {
|
|
dataChannel.removeEventListener(
|
|
"bufferedamountlow",
|
|
onBufferedAmountLow
|
|
);
|
|
resolve();
|
|
}, FileSender.OPTIMIZED_CONFIG.BACKPRESSURE_TIMEOUT);
|
|
});
|
|
}
|
|
|
|
if (!this.webrtcConnection.sendData(data, peerId)) {
|
|
throw new Error("sendData failed");
|
|
}
|
|
}
|
|
|
|
// 读取单个文件块的优化方法
|
|
private readSingleChunk(
|
|
fileReader: FileReader,
|
|
file: CustomFile,
|
|
offset: number,
|
|
chunkSize: number
|
|
): Promise<ArrayBuffer> {
|
|
return new Promise((resolve, reject) => {
|
|
const slice = file.slice(offset, offset + chunkSize);
|
|
fileReader.onload = (e) => {
|
|
if (e.target?.result instanceof ArrayBuffer) {
|
|
resolve(e.target.result);
|
|
} else {
|
|
reject(new Error("Failed to read blob as ArrayBuffer"));
|
|
}
|
|
};
|
|
fileReader.onerror = () =>
|
|
reject(fileReader.error || new Error("Read error"));
|
|
fileReader.readAsArrayBuffer(slice);
|
|
});
|
|
}
|
|
|
|
// 批量读取多个文件块，提升I/O性能
|
|
private async readMultipleChunks(
|
|
fileReader: FileReader,
|
|
file: CustomFile,
|
|
startOffset: number,
|
|
chunkSize: number,
|
|
batchSize: number
|
|
): Promise<ArrayBuffer[]> {
|
|
const chunks: ArrayBuffer[] = [];
|
|
const remainingSize = file.size - startOffset;
|
|
const actualBatchSize = Math.min(
|
|
batchSize,
|
|
Math.ceil(remainingSize / chunkSize)
|
|
);
|
|
|
|
for (let i = 0; i < actualBatchSize; i++) {
|
|
const offset = startOffset + i * chunkSize;
|
|
if (offset >= file.size) break;
|
|
|
|
const currentChunkSize = Math.min(chunkSize, file.size - offset);
|
|
const chunk = await this.readSingleChunk(
|
|
fileReader,
|
|
file,
|
|
offset,
|
|
currentChunkSize
|
|
);
|
|
chunks.push(chunk);
|
|
}
|
|
|
|
return chunks;
|
|
}
|
|
|
|
// 统一优化版本 - 使用批量读取+循环，适用于所有设备
|
|
private async processSendQueue(
|
|
file: CustomFile,
|
|
peerId: string
|
|
): Promise<void> {
|
|
const fileId = generateFileId(file);
|
|
const peerState = this.getPeerState(peerId);
|
|
const fileReader = new FileReader();
|
|
|
|
let offset = peerState.readOffset || 0;
|
|
const batchSize = FileSender.OPTIMIZED_CONFIG.BATCH_SIZE;
|
|
|
|
try {
|
|
// 使用批量读取+循环替代传统递归，大幅提升性能
|
|
while (offset < file.size && peerState.isSending) {
|
|
// 批量读取多个块
|
|
const chunks = await this.readMultipleChunks(
|
|
fileReader,
|
|
file,
|
|
offset,
|
|
this.chunkSize,
|
|
batchSize
|
|
);
|
|
|
|
if (chunks.length === 0) break;
|
|
|
|
// 批量发送所有读取的块
|
|
for (const chunk of chunks) {
|
|
if (!peerState.isSending || offset >= file.size) break;
|
|
|
|
await this.sendWithBackpressure(chunk, peerId);
|
|
|
|
// 更新进度
|
|
offset += chunk.byteLength;
|
|
peerState.readOffset = offset;
|
|
|
|
// 更新文件和文件夹进度
|
|
await this.updateProgress(
|
|
chunk.byteLength,
|
|
fileId,
|
|
file.size,
|
|
peerId
|
|
);
|
|
}
|
|
}
|
|
|
|
// 文件发送完毕
|
|
if (offset >= file.size && !peerState.currentFolderName) {
|
|
peerState.progressCallback?.(fileId, 1, 0);
|
|
}
|
|
} catch (error: any) {
|
|
this.fireError(`Error in optimized batch transfer: ${error.message}`, {
|
|
fileId,
|
|
peerId,
|
|
offset,
|
|
});
|
|
throw error;
|
|
}
|
|
}
|
|
|
|
//send fileEnd signal
|
|
private finalizeSendFile(fileId: string, peerId: string): void {
|
|
// this.log("log", `Finalizing file send for ${fileId} to ${peerId}`);
|
|
const endMessage = JSON.stringify({ type: "fileEnd", fileId });
|
|
if (!this.webrtcConnection.sendData(endMessage, peerId)) {
|
|
this.log("warn", `Failed to send fileEnd message for ${fileId}`);
|
|
}
|
|
// The isSending flag will be set to false upon receiving fileAck
|
|
}
|
|
|
|
private abortFileSend(fileId: string, peerId: string): void {
|
|
this.log("warn", `Aborting file send for ${fileId} to ${peerId}`);
|
|
const peerState = this.getPeerState(peerId);
|
|
peerState.isSending = false;
|
|
peerState.readOffset = 0;
|
|
peerState.bufferQueue = [];
|
|
peerState.isReading = false;
|
|
// Optionally, send an abort message to the receiver
|
|
}
|
|
}
|
|
|
|
export default FileSender;
|