@ives_xxz/framework 1.0.0

package/manager/FWAudioManager.ts

@@ -0,0 +1,289 @@
+import { FWManager } from './FWManager';
+import Framework from '../Framework';
+import FWLog from '../log/FWLog';
+
+export default class FWAudioManager extends FWManager implements FW.AudioManager {
+  /**背景音量 */
+  musicVolume: number = 1;
+  /**音效音量 */
+  effectsVolume: number = 1;
+  /**播放音效的音量 */
+  soundVolume: number = 1;
+
+  public initialize(): void {}
+
+  playMusic(path: string, volume?: number, loop?: boolean);
+  playMusic(music: cc.AudioClip, volume?: number, loop?: boolean);
+  playMusic(assetProperty: FW.AssetProperty, volume?: number, loop?: boolean);
+  async playMusic() {
+    try {
+      const data = await this.dataProcessing(arguments[0], arguments[1], arguments[2]);
+      if (!data) return;
+      const clip = data.clip;
+      const volume = data.volume === undefined ? this.musicVolume : arguments[1];
+      const loop = data.loop === undefined ? true : arguments[2];
+      const id = cc.audioEngine.playMusic(clip, loop);
+      cc.audioEngine.setVolume(id, volume);
+    } catch (e) {
+      FWLog.error('播放音乐失败:', e);
+    }
+  }
+
+  stopMusic(): void {
+    cc.audioEngine.stopMusic();
+  }
+  pauseMusic(): void {
+    cc.audioEngine.pauseMusic();
+  }
+  resumeMusic(): void {
+    cc.audioEngine.resumeMusic();
+  }
+  /**设置背景音效是否静音 */
+  setMusicMute(mute: boolean): void {
+    if (mute) {
+      this.musicVolume = 1;
+    } else {
+      this.musicVolume = 0;
+    }
+    cc.audioEngine.setMusicVolume(this.musicVolume);
+  }
+
+  async play(
+    path: string,
+    cb?: (id: number) => void,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<number>;
+  async play(
+    audio: cc.AudioClip,
+    cb?: (id: number) => void,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<number>;
+  async play(
+    assetProperty: FW.AssetProperty,
+    cb?: (id: number) => void,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<number>;
+  async play(): Promise<number> {
+    try {
+      const data = await this.dataProcessing(
+        arguments[0],
+        arguments[1],
+        arguments[2],
+        arguments[3],
+      );
+      if (!data) return;
+      const clip = data.clip;
+      const volume = data.volume === undefined ? this.soundVolume : arguments[1];
+      const loop = data.loop === undefined ? false : arguments[2];
+      const id = cc.audioEngine.play(clip, loop, volume);
+      cc.audioEngine.setFinishCallback(id, () => {
+        data.cb?.(id);
+      });
+      return id;
+    } catch (e) {
+      FWLog.error('播放音效失败:', e);
+    }
+  }
+  /**
+   *
+   * @param id 停止
+   */
+  public stop(id: number) {
+    cc.audioEngine.stop(id);
+  }
+  pauseAll(): void {
+    cc.audioEngine.pauseAll();
+  }
+  resumeAll(): void {
+    cc.audioEngine.resumeAll();
+  }
+  stopAll(): void {
+    cc.audioEngine.stopAll();
+  }
+  /**设置播放音效是否静音 */
+  setSoundMute(mute: boolean): void {
+    if (mute) {
+      this.soundVolume = 1;
+    } else {
+      this.soundVolume = 0;
+    }
+  }
+
+  /**播放音效 */
+  async playEffect(path: string, loop?: boolean): Promise<number>;
+  async playEffect(audio: cc.AudioClip, loop?: boolean): Promise<number>;
+  async playEffect(assetProperty: FW.AssetProperty, loop?: boolean): Promise<number>;
+  async playEffect(): Promise<number> {
+    try {
+      const data = await this.dataProcessing(arguments[0], arguments[1]);
+      if (!data) return;
+      const clip = data.clip;
+      const loop = data.loop === undefined ? false : arguments[1];
+      const id = cc.audioEngine.playEffect(clip, loop);
+      return id;
+    } catch (e) {
+      FWLog.error('播放音效失败:', e);
+    }
+  }
+
+  /**
+   * 停止音效
+   * @param effectName 声音文件名
+   * @returns
+   */
+  stopEffect(audioID: number): void {
+    if (!audioID) return;
+    return cc.audioEngine.stopEffect(audioID);
+  }
+  /**
+   * 设置音效音量
+   * @param volume 音量
+   */
+  setEffectsVolume(volume: number): void {
+    cc.audioEngine.setEffectsVolume(volume);
+  }
+  /**
+   * 停止播放所有音效
+   */
+  stopAllEffects(): void {
+    cc.audioEngine.stopAllEffects();
+  }
+  /**设置音效是否静音 */
+  setEffectsMute(mute: boolean): void {
+    if (mute) {
+      this.effectsVolume = 1;
+    } else {
+      this.effectsVolume = 0;
+    }
+    cc.audioEngine.setEffectsVolume(this.effectsVolume);
+  }
+
+  private async dataProcessing(
+    path: string,
+    cb?: (id: number) => void,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<{
+    clip: cc.AudioClip;
+    volume: number;
+    loop: boolean;
+    cb: (id: number) => void;
+  }>;
+
+  private async dataProcessing(
+    audio: cc.AudioClip,
+    cb?: (id: number) => void,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<{
+    clip: cc.AudioClip;
+    volume: number;
+    loop: boolean;
+    cb: (id: number) => void;
+  }>;
+
+  private async dataProcessing(
+    assetProperty: FW.AssetProperty,
+    cb?: (id: number) => void,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<{
+    clip: cc.AudioClip;
+    volume: number;
+    loop: boolean;
+    cb: (id: number) => void;
+  }>;
+
+  private async dataProcessing(
+    path: string,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<{
+    clip: cc.AudioClip;
+    volume: number;
+    loop: boolean;
+    cb: (id: number) => void;
+  }>;
+  private async dataProcessing(
+    music: cc.AudioClip,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<{
+    clip: cc.AudioClip;
+    volume: number;
+    loop: boolean;
+    cb: (id: number) => void;
+  }>;
+  private async dataProcessing(
+    assetProperty: FW.AssetProperty,
+    volume?: number,
+    loop?: boolean,
+  ): Promise<{
+    clip: cc.AudioClip;
+    volume: number;
+    loop: boolean;
+    cb: (id: number) => void;
+  }>;
+  private async dataProcessing(): Promise<{
+    clip: cc.AudioClip;
+    volume: number;
+    loop: boolean;
+    cb: (id: number) => void;
+  }> {
+    let clip: cc.AudioClip;
+    if (typeof arguments[0] === 'string') {
+      const bundle = FW.Entry.bundleName;
+      const path = arguments[0];
+      clip = await FW.Entry.resMgr.loadAsset<cc.AudioClip>(<FW.AssetProperty>{
+        path: path,
+        bundle: bundle,
+      });
+    } else if (typeof arguments[0] === 'object') {
+      const bundle = (arguments[0] as FW.AssetProperty).bundle || FW.Entry.bundleName;
+      const path = (arguments[0] as FW.AssetProperty).path;
+      clip = await FW.Entry.resMgr.loadAsset<cc.AudioClip>(<FW.AssetProperty>{
+        path: path,
+        bundle: bundle,
+      });
+    } else if (arguments[0] instanceof cc.AudioClip) {
+      clip = arguments[0];
+    }
+
+    let volume: number;
+
+    let loop: boolean;
+
+    let cb: (id: number) => void;
+    if (typeof arguments[1] === 'function') {
+      cb = arguments[1];
+    } else if (typeof arguments[1] === 'number') {
+      volume = arguments[1];
+    } else if (typeof arguments[1] === 'boolean') {
+      loop = arguments[1];
+    }
+
+    if (typeof arguments[2] === 'boolean') {
+      loop = arguments[2];
+    } else if (typeof arguments[2] === 'number') {
+      volume = arguments[2];
+    }
+
+    if (arguments.length == 4) {
+      loop = arguments[3];
+    }
+
+    return {
+      clip: clip,
+      volume: volume,
+      loop: loop,
+      cb: cb,
+    };
+  }
+
+  public onDestroy(): void {
+    this.stopAll();
+  }
+}

package/manager/FWAudioManager.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "c7cec874-a219-4fc7-aadf-c1e7a95d3fa0",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}

package/manager/FWBundleManager.ts

@@ -0,0 +1,91 @@
+import { FWManager } from './FWManager';
+import FWLog from '../log/FWLog';
+
+export class FWBundleManager extends FWManager implements FW.BundleManager {
+  bundleMap: Map<string, cc.AssetManager.Bundle>;
+  remoteBundleConfigMap: Map<string, FW.RemoteBundleConfig>;
+
+  constructor(protected readonly resMgr: FW.ResManager) {
+    super();
+  }
+
+  public initialize() {
+    this.bundleMap = new Map<string, cc.AssetManager.Bundle>();
+    this.remoteBundleConfigMap = new Map<string, FW.RemoteBundleConfig>();
+  }
+
+  public getBundleMap() {
+    return this.bundleMap;
+  }
+
+  public getRemoteBundleConfigMap() {
+    return this.remoteBundleConfigMap;
+  }
+
+  initializeRemoteBundleConfig(config: FW.RemoteBundleConfig): void {
+    this.remoteBundleConfigMap.set(config.bundleName, config);
+  }
+
+  async load(bundleName: string): Promise<cc.AssetManager.Bundle> {
+    if (!bundleName) return;
+    if (this.bundleMap.has(bundleName)) return this.bundleMap.get(bundleName);
+
+    return new Promise(
+      (
+        resolve: (value: cc.AssetManager.Bundle | PromiseLike<cc.AssetManager.Bundle>) => void,
+        reject: (reason?: any) => void,
+      ) => {
+        const remote = this.remoteBundleConfigMap.get(bundleName);
+        const url = remote ? remote.url : '';
+        const path = `${url}${bundleName}`;
+
+        cc.assetManager.loadBundle(
+          path,
+          { version: this.remoteBundleConfigMap.get(bundleName) || '' },
+          (err: Error, bundle: cc.AssetManager.Bundle) => {
+            if (err || !bundle) {
+              FWLog.error(`"加载bundle失败:"${bundleName}!`);
+              reject(err);
+            }
+            this.bundleMap.set(bundleName, bundle);
+            resolve(bundle);
+          },
+        );
+      },
+    );
+  }
+
+  /**
+   * 获取bundle
+   * @param bundleName
+   * @returns
+   */
+  get(bundleName: string): cc.AssetManager.Bundle {
+    if (!this.has(bundleName)) {
+      FWLog.error('获取bundle失败,请先加载!');
+      return undefined;
+    }
+    return this.bundleMap.get(bundleName);
+  }
+
+  /** 释放bundle */
+  release(bundleName: string): void {
+    if (!this.has(bundleName)) {
+      FWLog.warn('bundle未加载,无需释放!');
+      return;
+    }
+  }
+
+  /**
+   * 是否已经加载某个bundle
+   * @param bundleName
+   * @returns
+   */
+  has(bundleName: string): boolean {
+    return this.bundleMap.has(bundleName);
+  }
+
+  public onDestroy(): void {
+    this.bundleMap.clear();
+  }
+}

package/manager/FWBundleManager.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "8f7a5533-19cf-4b9f-a152-ae94b65d3042",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}

package/manager/FWComponentManager.ts

@@ -0,0 +1,25 @@
+import FWVirtualViewComponent from '../component/FWVirtualViewComponent';
+import { FWManager } from './FWManager';
+
+export default class FWComponentManager extends FWManager implements FW.ComponentManager {
+  public initialize(): void {}
+  public onDestroy(): void {}
+
+  /**
+   * 绑定虚拟视图列表
+   */
+  bindVirtualViewComponent(args: FW.VirtualViewComponentArgs) {
+    args.virtualView.onRender = args.onRender?.bind(args.target);
+    args.virtualView.onSelected = args.onSelected?.bind(args.target);
+    args.virtualView.onPageChange = args.onPageChange?.bind(args.target);
+    args.virtualView.count = args.count;
+
+    if (args.templatePrefab) {
+      args.virtualView.templatePrefab = args.templatePrefab;
+    }
+
+    if (args.templateNode) {
+      args.virtualView.templateNode = args.templateNode;
+    }
+  }
+}

package/manager/FWComponentManager.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "8a40e7b7-9eb6-4236-96fb-afe4d9429a8a",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}

package/manager/FWEngineManager.ts

@@ -0,0 +1,63 @@
+import { FWSystemDefine } from '../define/FWSystemDefine';
+import FWLog from '../log/FWLog';
+import { FWManager } from './FWManager';
+
+export default class FWEngineManager extends FWManager implements FW.EngineManager {
+  debug: boolean = CC_DEBUG;
+  initialize() {
+    this.registerCCCSystemEvent();
+  }
+
+  onDestroy(): void {
+    cc.game.off(cc.game.EVENT_SHOW, this.onAppShow, this);
+    cc.game.off(cc.game.EVENT_HIDE, this.onAppHide, this);
+  }
+
+  getMemory() {
+    if (!this.debug) return;
+    if (window.performance && window.performance['memory']) {
+      FWLog.debug(
+        '浏览器允许的最大内存:',
+        this.formatBytes(window.performance['memory'].jsHeapSizeLimit),
+      );
+      FWLog.debug(
+        '浏览器已分配内存:',
+        this.formatBytes(window.performance['memory'].totalJSHeapSize),
+      );
+      FWLog.debug(
+        '浏览器已使用内存:',
+        this.formatBytes(window.performance['memory'].usedJSHeapSize),
+      );
+    } else {
+      FWLog.debug('当前浏览器不支持 performance.memory');
+    }
+  }
+  /**
+   * 注册cocos系统事件
+   */
+  private registerCCCSystemEvent() {
+    cc.game.on(cc.game.EVENT_SHOW, this.onAppShow, this);
+    cc.game.on(cc.game.EVENT_HIDE, this.onAppHide, this);
+  }
+  /** 应用切换到前台 */
+  private onAppShow() {
+    FWLog.debug('game on show!');
+    FW.Entry.evtMgr?.dispatch(FWSystemDefine.CCEventType.ON_SHOW);
+  }
+
+  /** 应用切换到后台 */
+  private onAppHide() {
+    FWLog.debug('game on hide!');
+    FW.Entry.evtMgr?.dispatch(FWSystemDefine.CCEventType.ON_HIDE);
+  }
+
+  private formatBytes(bytes: number) {
+    if (bytes < 1024 * 1024) {
+      return (bytes / 1024).toFixed(2) + ' KB';
+    } else if (bytes < 1024 * 1024 * 1024) {
+      return (bytes / 1024 / 1024).toFixed(2) + ' MB';
+    } else {
+      return (bytes / 1024 / 1024 / 1024).toFixed(2) + ' GB';
+    }
+  }
+}

package/manager/FWEngineManager.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "dcaa0ad6-aa1c-4103-9705-2777da3e2e83",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}