библиотека game-utils для поддержки игр

Эта библиотека включает две части:

• Библиотека API (включает определения SDK для мини-игр WeChat, QQ, Douyin и Vivo) для прямого использования.

• Библиотека ET (включает часто используемые классы помощи для игр и некоторые расширенные методы).

Область применения

Поддерживаемые движки

• Egret
• Cocos
• Laya
• Pixi

Поддерживаемые мини-игры

• Мини-игры WeChat
• Мини-игры QQ
• Мини-игры Douyin
• Мини-игры Vivo

Как использовать

Инициализация основного класса et.app

• Автоматическое управление событиями «переход в фон»/«возврат на передний план»
• Автоматическое управление проблемой «черный текст»

var app = new et.app();
app.init(this.stage);

Управление ресурсами```typescript

// Предварительная загрузка группы ресурсов (здесь просто предварительно кэшируются необходимые для загрузки ресурсы) et.egretRes.pushRes("preload", (event: egret.Event)=>{ // TODO: Событие о прогрессе загрузки ресурсов console.log("Прогресс загрузки ресурсов:", Math.round(event.itemsLoaded / event.itemsTotal * 100), "%", event.groupName); }, (event: egret.Event)=>{ // TODO: Событие о завершении загрузки ресурсов }, (event: egret.Event)=>{ // TODO: Событие об ошибке при загрузке ресурсов // Этот метод можно не реализовывать, так как он автоматически обрабатывается фреймворком });

et.egretRes.pushRes("common");

// Начало загрузки ресурсов (здесь начинается фактическая загрузка ресурсов)
// true: После успешной загрузки удалите ресурсы из списка кэша
et.egretRes.loadRes(true);

### Инициализация информации о игре

```typescript
// Создание информации о игре для платформы WeChat
let appInfo = new et.AppInfo(et.Platform.Wxgame);
appInfo.appId = "ваш appId";
appInfo.bannerId = "ваш bannerId";
appInfo.videoId = "ваш videoId";
// Использование вышеописанного основного класса
et.app.instance.initApp(appInfo);

Отображение баннера рекламы

// Необходимо создать информацию о игре для платформы перед отображением баннера
await et.app.instance.showBannerAd();

API для мини-игр

Все мини-игры не требуют учета пространства имён, могут быть запущены на нескольких платформах с одним набором кода. Пространство имён для всех API установлено как api. Вот пример конечного вывода API для различных платформ:

// api.getSystemInfoSync() — метод для WeChat Mini Programs
// api.getSystemInfoSync() — метод для QQ Mini Games
// api.getSystemInfoSync() — метод для头条 Mini Games
// api.getSystemInfoSync() — метод для Quick Apps (VIVO/Oppo/Xiaomi)
let systemInfo = api.getSystemInfoSync(); // Для вызова этих методов достаточно использовать пространство имён api

Поддерживаемые API

Чтобы облегчить поиск поддерживаемых методов, данные разделены на отдельные базы данных.

Внимание: Ниже приведена информация только для платформы WeChat.#### Базовая библиотека| Название API | Поддержка | | ---------------------------------- | ----------| | getSystemInfoSync | Полностью поддерживается | | getSystemInfo | Полностью поддерживается | | getUpdateManager | Полностью поддерживается | | onShow | Полностью поддерживается | | onHide | Полностью поддерживается | | offShow | Полностью поддерживается | | offHide | Полностью поддерживается | | getLaunchOptionsSync | Полностью поддерживается | | exitMiniProgram | Полностью поддерживается | | onError | Полностью поддерживается | | onAudioInterruptionEnd | Полностью поддерживается | | onAudioInterruptionBegin | Полностью поддерживается | | offError | Полностью поддерживается | | offAudioInterruptionEnd | Полностью поддерживается | | offAudioInterruptionBegin | Полностью поддерживается | | onTouchStart | Полностью поддерживается | | onTouchMove | Полностью поддерживается | | onTouchEnd | Полностью поддерживается | | onTouchCancel | Полностью поддерживается | | offTouchStart | Полностью поддерживается | | offTouchMove | Полностью поддерживается | | offTouchEnd | Полностью поддерживается | | offTouchCancel | Полностью поддерживается | | triggerGC | Полностью поддерживается | | markScene | Полностью поддерживается | | getPerformance | Полностью поддерживается || loadSubpackage | Полностью поддерживается | | setEnableDebug | Полностью поддерживается | | getLogManager | Полностью поддерживается | | console | Полностью поддерживается | | LogManager | Полностью поддерживается | | clearInterval | Полностью поддерживается | | clearTimeout | Полностью поддерживается | | setInterval | Полностью поддерживается | | setTimeout | Полностью поддерживается |

Библиотека рендера| createCanvas | Полностью поддерживается |

| ----------------------------- | ------------------------- | | Canvas | Полностью поддерживается | | RenderingContext | Полностью поддерживается | | wxBindCanvasTexture | Поддерживается движком | | setPreferredFramesPerSecond | Полностью поддерживается | | cancelAnimationFrame | Полностью поддерживается | | requestAnimationFrame | Полностью поддерживается | | loadFont | Полностью поддерживается | | getTextLineHeight | Полностью поддерживается | | createImage | Полностью поддерживается | | Image | Полностью поддерживается |

• Библиотека рекламы

• Интерфейсная библиотека| showToast | Полностью поддерживается | | --------------------------------- | ------------------------- | | showModal | Полностью поддерживается | | showLoading | Полностью поддерживается | | showActionSheet | Полностью поддерживается | | hideToast | Полностью поддерживается | | hideLoading | Полностью поддерживается | | updateKeyboard | Полностью поддерживается | | showKeyboard | Полностью поддерживается | | onKeyboardInput | Полностью поддерживается | | onKeyboardConfirm | Полностью поддерживается | | onKeyboardComplete | Полностью поддерживается | | offKeyboardInput | Полностью поддерживается | | offKeyboardConfirm | Полностью поддерживается | | offKeyboardComplete | Полностью поддерживается | | hideKeyboard | Полностью поддерживается | | setMenuStyle | Полностью поддерживается | | getMenuButtonBoundingClientRect | Полностью поддерживается | | onWindowResize | Полностью поддерживается | | offWindowResize | Полностью поддерживается |- Библиотека сети

Библиотека открытых интерфейсов| navigateToMiniProgram | Полностью поддерживается |

| --------------------------------- | ------------------------- | | getUserInfo | Полностью поддерживается | | getUserGameLabel | Полностью поддерживается | | createUserInfoButton | Полностью поддерживается | | UserInfo | Полностью поддерживается | | UserInfoButton | Полностью поддерживается | | login | Полностью поддерживается | | checkSession | Полностью поддерживается | | authorize | Полностью поддерживается | | shareMessageToFriend | Полностью поддерживается | | setUserCloudStorage | Полностью поддерживается | | removeUserCloudStorage | Полностью поддерживается | | onInteractiveStorageModified | Полностью поддерживается | | modifyFriendInteractiveStorage | Полностью поддерживается | | getUserInteractiveStorage | Неподдерживаемо | | getUserCloudStorage | Неподдерживаемо | | getSharedCanvas | Неподдерживаемо | | getPartialFriendList | Неподдерживаемо | | getGroupCloudStorage | Неподдерживаемо | | getFriendCloudStorage | Неподдерживаемо | | FriendInfo | Неподдерживаемо | | KVData | Полностью поддерживается | | UserGameData | Неподдерживаемо | | onMessage | Неподдерживаемо | | getOpenDataContext | Неподдерживаемо | | OpenDataContext | Неподдерживаемо | | checkIsUserAdvisedToRest | Неподдерживаемо | | createFeedbackButton | Неподдерживаемо || FeedBackButton | Неподдерживаемо | | openSetting | Неподдерживаемо | | getSetting | Неподдерживаемо | | createOpenSettingButton | Неподдерживаемо | | AuthSetting | Неподдерживаемо | | OpenSettingButton | Неподдерживаемо | | createGameClubButton | Неподдерживаемо | | GameClubButton | Неподдерживаемо | | openCustomerServiceConversation | Неподдерживаемо | | getWeRunData | Неподдерживаемо | | openCard | Неподдерживаемо | | addCard | Неподдерживаемо | | reportMonitor | Неподдерживаемо | | requestSubscribeSystemMessage | Неподдерживаемо | | requestSubscribeMessage | Неподдерживаемо |