2019-11-23 20:27:39 +08:00
|
|
|
/****************************************************************************
|
|
|
|
Copyright (c) 2010-2012 cocos2d-x.org
|
|
|
|
Copyright (c) 2013-2016 Chukong Technologies Inc.
|
|
|
|
Copyright (c) 2017-2018 Xiamen Yaji Software Co., Ltd.
|
|
|
|
|
2022-10-01 16:24:52 +08:00
|
|
|
https://axmolengine.github.io/
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
THE SOFTWARE.
|
|
|
|
****************************************************************************/
|
|
|
|
|
2022-07-16 10:43:05 +08:00
|
|
|
#ifndef __AX_APPLICATION_PROTOCOL_H__
|
|
|
|
#define __AX_APPLICATION_PROTOCOL_H__
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2023-06-11 13:08:08 +08:00
|
|
|
#include "platform/PlatformMacros.h"
|
|
|
|
#include "base/AutoreleasePool.h"
|
|
|
|
#include "base/Types.h"
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_BEGIN
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @addtogroup platform
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
2022-07-16 10:43:05 +08:00
|
|
|
class AX_DLL ApplicationProtocol
|
2019-11-23 20:27:39 +08:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
/** Since WINDOWS and ANDROID are defined as macros, we could not just use these keywords in enumeration(Platform).
|
2022-06-20 01:49:50 +08:00
|
|
|
* Therefore, we use C# code style to define Platform enums to avoid conflicts with the definitions of system macros.
|
2019-11-23 20:27:39 +08:00
|
|
|
*/
|
|
|
|
enum class Platform
|
|
|
|
{
|
2022-06-20 01:49:50 +08:00
|
|
|
Windows, /**< Windows */
|
2023-03-11 22:10:18 +08:00
|
|
|
UWP,
|
|
|
|
UWP_Phone,
|
2022-06-20 01:49:50 +08:00
|
|
|
Linux, /**< Linux */
|
|
|
|
macOS, /**< macOS */
|
|
|
|
Android, /**< Android */
|
2023-09-01 16:31:14 +08:00
|
|
|
Emscripten, /**< Emscripten */
|
2022-06-20 01:49:50 +08:00
|
|
|
iOS, /**< Apple iOS */
|
2019-11-23 20:27:39 +08:00
|
|
|
};
|
|
|
|
|
2023-03-11 22:10:18 +08:00
|
|
|
enum class SubPlatform {
|
|
|
|
Null,
|
|
|
|
Win32,
|
|
|
|
WinRT,
|
|
|
|
tvOS,
|
|
|
|
};
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2021-12-25 10:04:45 +08:00
|
|
|
virtual ~ApplicationProtocol()
|
|
|
|
{
|
2019-11-23 20:27:39 +08:00
|
|
|
/** clean auto release pool. */
|
|
|
|
PoolManager::destroyInstance();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2021-12-25 10:04:45 +08:00
|
|
|
* @brief Implement Director and Scene init code here.
|
|
|
|
* @return true Initialize success, app continue.
|
|
|
|
* @return false Initialize failed, app terminate.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2019-11-23 20:27:39 +08:00
|
|
|
virtual bool applicationDidFinishLaunching() = 0;
|
|
|
|
|
|
|
|
/**
|
2021-12-25 10:04:45 +08:00
|
|
|
* @brief This function will be called when the application enters background.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2019-11-23 20:27:39 +08:00
|
|
|
virtual void applicationDidEnterBackground() = 0;
|
|
|
|
|
|
|
|
/**
|
2021-12-25 10:04:45 +08:00
|
|
|
* @brief This function will be called when the application enters foreground.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2019-11-23 20:27:39 +08:00
|
|
|
virtual void applicationWillEnterForeground() = 0;
|
|
|
|
|
2022-06-30 21:04:00 +08:00
|
|
|
/**
|
|
|
|
* @brief Callback by Director for limit FPS.
|
|
|
|
* @param interval The time, expressed in seconds, between current frame and next.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual void setAnimationInterval(float interval) = 0;
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/** Subclass override the function to set OpenGL context attribution instead of use default value.
|
2021-12-25 10:04:45 +08:00
|
|
|
* And now can only set six attributions:redBits,greenBits,blueBits,alphaBits,depthBits,stencilBits.
|
|
|
|
* Default value are(5,6,5,0,16,0), usually use as follows:
|
|
|
|
* void AppDelegate::initGLContextAttrs(){
|
|
|
|
* GLContextAttrs glContextAttrs = {8, 8, 8, 8, 24, 8};
|
|
|
|
* GLView::setGLContextAttrs(glContextAttrs);
|
|
|
|
* }
|
|
|
|
*/
|
2019-11-23 20:27:39 +08:00
|
|
|
virtual void initGLContextAttrs() {}
|
|
|
|
|
|
|
|
/**
|
|
|
|
@brief Get current language config.
|
|
|
|
@return Current language config.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual LanguageType getCurrentLanguage() = 0;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
@brief Get current language iso 639-1 code.
|
|
|
|
@return Current language iso 639-1 code.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2021-12-25 10:04:45 +08:00
|
|
|
virtual const char* getCurrentLanguageCode() = 0;
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
@brief Get target platform.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual Platform getTargetPlatform() = 0;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
@brief Get application version.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual std::string getVersion() = 0;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
@brief Open url in default browser.
|
|
|
|
@param String with url to open.
|
|
|
|
@return True if the resource located by the URL was successfully opened; otherwise false.
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2021-12-31 12:12:40 +08:00
|
|
|
virtual bool openURL(std::string_view url) = 0;
|
2019-11-23 20:27:39 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
// end of platform group
|
|
|
|
/** @} */
|
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_END
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2022-07-16 10:43:05 +08:00
|
|
|
#endif // __AX_APPLICATION_PROTOCOL_H__
|