UML

点击查看【processon】
一个游戏对应一个Application对象，Application的职责就是管理游戏生命周期并设置默认窗口，获取平台及本地化信息等。不同平台初始化对应的平台实现的Application。cocos脚本工具会帮我们创建一个Applicatioin的子类AppDelegate，通过它我们可以自定义生命周期各个阶段的处理。

ApplicationProtocol

抽象基类，规定了一个Application必须实现的接口。

  2. class ApplicationProtocol{
  3. public:
  4.     //Implement Director and Scene init code here
  5.     //true    Initialize success, app continue.
  6.     //false   Initialize failed, app terminate.
  7.     virtual bool applicationDidFinishLaunching() = 0;
  9.     //程序进入后台时，被调用，比如处理音乐
  10.     virtual void applicationDidEnterBackground() = 0;
  12.     //程序 enters foreground时，被调用，比如处理音乐
  13.     virtual void applicationWillEnterForeground() = 0;
  15.     //设置帧刷新速率（interval是两帧的时间间隔）
  16.     //director会调用它来设置速率，已由cocos内部实现。
  17.     virtual void setAnimationInterval(float interval) = 0;
  19.     // 在创建GL Window前，用于设置以下GL上下文属性（Context Attrs）
  20.     //        1、设置默认帧缓冲的颜色、深度、模板缓冲的分量大小（bit depth）
  21.     //            颜色缓冲：R、G、B、A bit
  22.     //            深度缓冲：depth bit
  23.     //            模板缓冲：stencil bit
  24.     //        2、设置纹理采样点数，用于多重采样（抗锯齿），默认只为0，表示不开启多重采样。
  25.     virtual void initGLContextAttrs() {}
  26.     // 一般如下设置：
  27.     // void AppDelegate::initGLContextAttrs(){
  28.     //       // 数值依次对应R bit、G bit、B bit、A bit、depth bit、stencil bit和采样点数
  29.     //     GLContextAttrs glContextAttrs = {8, 8, 8, 8, 24, 8, 0};
  30.     //     GLView::setGLContextAttrs(glContextAttrs);
  31.     // }
  33.     //Get current language config.
  34.     virtual LanguageType getCurrentLanguage() = 0;
  36.     //Get current language iso 639-1 code.
  37.     virtual const char * getCurrentLanguageCode() = 0;
  39.     //Get target platform.
  40.     virtual Platform getTargetPlatform() = 0;
  42.     //Get application version.
  43.     virtual std::string getVersion() = 0;
  45.     //Open url in default browser.
  46.     //True if the resource located by the URL was successfully opened; otherwise false.
  47.     virtual bool openURL(const std::string &url) = 0;
  48. };

AppDelegate

这里列举的是比较常见的实现。

  2. // if you want a different context, modify the value of glContextAttrs
  3. // it will affect all platforms
  4. void AppDelegate::initGLContextAttrs()
  5. {
  6.     // set OpenGL context attributes: red,green,blue,alpha,depth,stencil, 采样点数（0为不开启采样）
  7.     GLContextAttrs glContextAttrs = {8, 8, 8, 8, 24, 8, 0};
  9.     GLView::setGLContextAttrs(glContextAttrs);
  10. }
  12. bool AppDelegate::applicationDidFinishLaunching()
  13. {
  14.     // *********************************************
  15.     // *** 初始化director
  16.     // *********************************************
  18.     auto director = Director::getInstance();
  19.     auto glview = director->getOpenGLView();
  21.     // *********************************************
  22.     // *** 创建GL Window
  23.     // *********************************************
  24.     if(!glview) {
  25.         glview = GLViewImpl::create("Cpp Tests");   
  26.         director->setOpenGLView(glview);
  27.     }
  29.     director->setDisplayStats(true);
  30.     director->setAnimationInterval(1.0f / 60);
  32.     // *********************************************
  33.     // *** 设置资源搜索路径，不同分辨率使用不同资源
  34.     // *********************************************
  35.     std::vector<std::string> searchPaths;
  36.     ......
  37.     FileUtils::getInstance()->setSearchPaths(searchPaths);
  39.     // *********************************************
  40.     // *** 屏幕适配
  41.     // *********************************************
  42.     auto screenSize = glview->getFrameSize();
  43.     auto designSize = Size(480, 320);
  44.     glview->setDesignResolutionSize(designSize.width, designSize.height, ResolutionPolicy::NO_BORDER);
  46.     return true;
  47. }
  49. void AppDelegate::applicationDidEnterBackground()
  50. {
  51.     // 暂停声音
  53.     Director::getInstance()->stopAnimation();
  54. }
  56. void AppDelegate::applicationWillEnterForeground()
  57. {
  58.     // 恢复声音
  60.     Director::getInstance()->startAnimation();
  61. }