四零语境前端代码仓库
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

219 lines
6.3 KiB

/**
* 音频相关工具方法
* 从 AudioControls.vue 抽离的通用工具方法
*/
/**
* 智能分割文本,按句号和逗号分割中英文文本
* @param {string} text - 要分割的文本
* @returns {Array} 分割后的文本段落数组
*/
export function splitTextIntelligently(text) {
if (!text || typeof text !== 'string') {
return [text];
}
// 判断是否为中文文本(包含中文字符)
const isChinese = /[\u4e00-\u9fa5]/.test(text);
const maxLength = isChinese ? 100 : 200;
// 如果文本长度不超过限制,直接返回
if (text.length <= maxLength) {
return [{
text: text,
startIndex: 0,
endIndex: text.length - 1
}];
}
const segments = [];
let currentText = text;
let globalStartIndex = 0;
while (currentText.length > 0) {
if (currentText.length <= maxLength) {
// 剩余文本不超过限制,直接添加
segments.push({
text: currentText,
startIndex: globalStartIndex,
endIndex: globalStartIndex + currentText.length - 1
});
break;
}
// 在限制长度内寻找最佳分割点
let splitIndex = maxLength;
let bestSplitIndex = -1;
// 优先寻找句号
for (let i = Math.min(maxLength, currentText.length - 1); i >= Math.max(0, maxLength - 50); i--) {
const char = currentText[i];
if (char === '。' || char === '.') {
bestSplitIndex = i + 1; // 包含句号
break;
}
}
// 如果没找到句号,寻找逗号
if (bestSplitIndex === -1) {
for (let i = Math.min(maxLength, currentText.length - 1); i >= Math.max(0, maxLength - 50); i--) {
const char = currentText[i];
if (char === ',' || char === ',' || char === ';' || char === ';') {
bestSplitIndex = i + 1; // 包含标点符号
break;
}
}
}
// 如果还是没找到合适的分割点,使用默认长度
if (bestSplitIndex === -1) {
bestSplitIndex = maxLength;
}
// 提取当前段落
const segment = currentText.substring(0, bestSplitIndex).trim();
if (segment.length > 0) {
segments.push({
text: segment,
startIndex: globalStartIndex,
endIndex: globalStartIndex + segment.length - 1
});
}
// 更新剩余文本和全局索引
currentText = currentText.substring(bestSplitIndex).trim();
globalStartIndex += bestSplitIndex;
}
return segments;
}
/**
* 格式化时间显示
* @param {number} seconds - 秒数
* @returns {string} 格式化后的时间字符串 (mm:ss)
*/
export function formatTime(seconds) {
const mins = Math.floor(seconds / 60);
const secs = Math.floor(seconds % 60);
return `${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
}
/**
* 生成音频缓存键
* @param {string} courseId - 课程ID
* @param {number} pageNumber - 页面号码
* @param {string} voiceId - 音色ID
* @returns {string} 缓存键
*/
export function generateCacheKey(courseId, pageNumber, voiceId) {
return `${courseId}_${pageNumber}_${voiceId}`;
}
/**
* 验证缓存数据的有效性
* @param {Object} cachedData - 缓存的音频数据
* @param {number} expectedPage - 期望的页面号码
* @returns {boolean} 缓存数据是否有效
*/
export function validateCacheData(cachedData, expectedPage) {
if (!cachedData || !cachedData.audios || cachedData.audios.length === 0) {
return false;
}
// 检查页面号码匹配
if (expectedPage !== null && cachedData.pageNumber && cachedData.pageNumber !== expectedPage) {
return false;
}
// 检查音频URL有效性
const firstAudio = cachedData.audios[0];
if (!firstAudio || !firstAudio.url) {
return false;
}
return true;
}
/**
* 查找第一个非导语音频的索引
* @param {Array} audioArray - 音频数组
* @returns {number} 第一个非导语音频的索引,如果没有找到返回-1
*/
export function findFirstNonLeadAudio(audioArray) {
if (!audioArray || audioArray.length === 0) {
return -1;
}
// 从第一个音频开始查找非导语音频
for (let i = 0; i < audioArray.length; i++) {
const audioData = audioArray[i];
if (audioData && !audioData.isLead) {
return i;
}
}
// 如果所有音频都是导语,返回 -1 表示不播放
return -1;
}
/**
* 限制缓存大小,保留最近访问的页面
* @param {Object} audioCache - 音频缓存对象
* @param {number} maxSize - 最大缓存数量,默认10
* @returns {Object} 清理后的缓存对象
*/
export function limitCacheSize(audioCache, maxSize = 10) {
const cacheKeys = Object.keys(audioCache);
if (cacheKeys.length > maxSize) {
// 删除最旧的缓存项
const keysToDelete = cacheKeys.slice(0, cacheKeys.length - maxSize);
keysToDelete.forEach(key => {
delete audioCache[key];
});
}
return audioCache;
}
/**
* 清理音频缓存
* @param {Object} audioCache - 音频缓存对象
* @returns {Object} 清空的缓存对象
*/
export function clearAudioCache(audioCache) {
return {};
}
/**
* 音频状态重置工具
* @param {Object} audioState - 音频状态对象
* @param {boolean} clearHighlight - 是否清除高亮索引,默认true
* @returns {Object} 重置后的状态对象
*/
export function resetAudioState(audioState, clearHighlight = true) {
const resetState = {
...audioState,
isPlaying: false,
currentTime: 0,
sliderValue: 0
};
if (clearHighlight) {
resetState.currentHighlightIndex = -1;
}
return resetState;
}
/**
* 检查音频数据是否属于当前页面
* @param {Object} audioData - 音频数据
* @param {string} expectedCacheKey - 期望的缓存键
* @returns {boolean} 是否属于当前页面
*/
export function isAudioDataForCurrentPage(audioData, expectedCacheKey) {
if (!audioData || !audioData.cacheKey) {
return false;
}
return audioData.cacheKey === expectedCacheKey;
}