【鸣潮，原神PC端启动器】仿二次元手游PC端游戏启动器，以鸣潮为例。

2024-11-16 10:26:07 作者：佚名

二游GAMELauncher启动器

1.前言

许多二次元手游（原神，鸣潮，少女前线）的PC端启动器都是使用Qt做的，正好最近正在玩鸣潮，心血来潮，便仿鸣潮启动器，从头写一个。先下载一个官方版的PC启动器，找到图标，背景图等素材，然后对着界面写代码就行。
效果如下

2. 划分模块

游戏启动器大致可以分为六部分
- 主体窗口
- 顶部标题栏
- 公告栏
- 轮播图
- 游戏下载模块
- 设置对话框
模块划分后，要做的事就很清晰了，对每一个模块，都新建一个带ui(方便布局)的类，然后根据各模块功能分别实现，最后组装在一起就行。

3. 主体窗口

主体窗口是一个无边框窗口，然后有动态的背景图，有logo，版本号，版本标题。
- Qt中设置无边框窗口很简单，只要一行代码即可
```
  this->setWindowFlags(Qt::FramelessWindowHint | windowFlags());
```
  这会导致窗口原本的移动事件和缩放事件无效，移动事件我们留在标题栏部分实现，缩放事件我们则不需要。
- 动态背景图，其实是通过定时切换图片实现，这时我们很容易想到使用定时器实现，到时间就就加载下一张图片。
  
  这样做会有一个问题，加载图片是需要时间的，这样做界面会有卡顿感。我们可以先把所有图片加载到内存，然后就不需要加载了，可以解决卡顿感。
  
  但是这又会导致另一个问题，图片很多，全部加载会占用很多内存空间，不够优雅。这里就需要用到线程，我们可以使用线程加载图片，然后通过信号把加载好的图片发送给主窗口就行绘制，这样既不卡顿也不占用很多内存。
- 新建一个加载图片的类(LoadImage)，继承QThread，实现run方法。
```
   while (!stop)
   {
        if (!imgNameList.EMPty())
        {
            QPixmap pix = QPixmap(imgNameList[curIndex]);
            curIndex = (curIndex + 1) % imgNameList.Size();
            emit sendPixmap(pix);
        }
        QThread::msleep(fps);
    }
```
  我们可以设定帧数，让背景图实现指定帧率刷新。
- 这样我们就实现了背景图的切换
- 然后我们把那些logo，版本号，标题，根据对应位置绘制上去就行了。logo 和 slogan都是图片来的。
```
 //绘制logo 和 slogan
    p.drawImage(0,this->height()-slogan.height(),this->slogan);
    p.drawImage(50,120,this->logo
   //绘制版本号
    QPen pen;
    pen.setWidth(1);
    pen.setColor(Qt::white);
    p.setPen(pen);
    QFont font("Arial", 12, QFont::Bold);
    p.setFont(font);
    p.drawText(10,this->height()-10,versionNumber);
```
- 这样就得到了主体视觉图

主体窗口还需要接收来自标题栏的移动，最小化，关闭的信号。

    connect(ui->topBar,&TopBar::miniumWindow,[this]()
    {
        this->showMinimized();
    });
    connect(ui->topBar,&TopBar::closeWindow,[this]()
    {
        this->close();
    });
    connect(ui->topBar,&TopBar::moveWindow,[this](QPoint pos)
    {
        this->move(pos+this->pos());
    });

4. 顶部标题栏

标题栏用一个QWidget,然后把背景颜色设置成 rgba(0,0,0,80) 就可以实现透明的样式。其它的控件就是很常规的，里面有些按钮是有渐变的背景色和底部有白线，我们可以用一个QWidget加一个QPushButton作为一个组件实现，使用QWidget控件方便绘制白线。还有鼠标悬浮时显示的类似气泡的对话框，这个对话框需要自己实现。

气泡框可以通过把QWidget设置为无边框和透明窗口，然后里面绘制一个圆角矩形，然后再画一个三角形箭头即可。

setWindowFlags(Qt::FramelessWindowHint);
setAttribute(Qt::WA_TranslucentBackground);

void BubbleWidget::paintEvent(QPaintEvent*event)
{

    QPainter painter(this);
    painter.setRenderHint(QPainter::Antialiasing);

    // 设置背景颜色和边框
    painter.setBrush(Qt::white);
    painter.setPen(QPen(Qt::gray, 1));

    // 创建圆角矩形路径
    QPainterPath path;
    QRectF rect = this->rect().adjusted(1, 10, -1,1); // 为箭头留出空间

    path.addRoundedRect(rect, 6, 6);
    painter.drawPath(path);
    path.clear();
    // 添加三角形箭头
    int arrowWidth = 15;
    int arrowHeight = 6;
    QVector<QPointF>points =
    {
        QPointF(rect.center().x() - arrowWidth / 2, rect.top()),
        QPointF(rect.center().x() + arrowWidth / 2, rect.top()),
        QPointF(rect.center().x(), rect.top() - arrowHeight)
    };
    path.addPolygon(QPolygonF(points));

    // 绘制路径
    painter.drawPath(path);

然后我们可以根据需要往这个气泡框设置不同的Layout，就可以实现不同的布局效果了。
把其他控件放上就可以得到下面的标题栏，我们在这个类里面把移动，关闭，最小化的信号发给父窗口即可。
然后得到一个带标题栏的窗口。

5. 公告栏

公告栏可以用QFrame和QStackedWidget组合实现，每条公告需要自定义一个QWiget来表示，处理好气泡框提示以及绘制左则的竖线。剩下就是对样式的设置，需要慢慢调一下。

6. 轮播图

轮播图使用QWiget和两个QPushButton实现，按钮固定在中间的左右两则，鼠标进入轮播图时显示。QWiget负责绘制轮播图片，图片切换是带一定动画效果的，不能直接切换图片。

轮播图上使用缓出动画效果，使得切换图片时更平滑。我们可以使用Qt的属性动画QPropertyAnimation，让图片位置属性 offset 按缓和曲线进行变动，然后根据属性变化绘制当前图片和下一张图片即可。

  animation = new QPropertyAnimation(this, "offset");
  animation->setStartValue(0.0);
  animation->setEndValue(1.0);
  animation->setDuration(400);
  animation->setEasingCurve(QEasingCurve::OutCubic);   //缓出效果

  void Carousel::paintEvent(QPaintEvent*e)
  {
       QPainter p(this);
    if(!left)
    {

        p.drawImage(QRect(-width() * offset, 0, width(), height()), imgArr.at(curIndex).scaled(width(),height(),Qt::KeepAspectRatio,Qt::SmoothTransformation));
        // 绘制下一张图片
        p.drawImage(QRect(width() * (1 - offset), 0, width(), height()), imgArr.at(nextIndex).scaled(width(),height(),Qt::KeepAspectRatio,Qt::SmoothTransformation));
    }
    else
    {
        p.drawImage(QRect(width() * offset, 0, width(), height()), imgArr.at(curIndex).scaled(width(),height(),Qt::KeepAspectRatio,Qt::SmoothTransformation));
        // 绘制下一张图片
        p.drawImage(QRect(-width() * (1 - offset), 0, width(), height()), imgArr.at(nextIndex).scaled(width(),height(),Qt::KeepAspectRatio,Qt::SmoothTransformation));

    }
  }

效果如下

图片进行缩放时要使用 Qt::SmoothTransformation ，不然图片会很模糊。

7. 下载模块

这个模块就比较简单，使用QWidget+QStackedWidget，实现下载界面和进入游戏界面的切换。
- 有一些细节注意，QLineEdit要实现有个图标在最右侧可以使用 addAction函数 ，添加一个图标。当QLineEdit的文字内容过长时，要让光标位于最开始位置，可以设置
  
  setCursorPosition(0) 。还需要把QLineEdit自动获取鼠标焦点功能禁用，设置 setFocusPolICY(Qt::NoFocus) 。

8. 设置

设置界面比较麻烦，里面的QCheckBox和QRadioButton的效果无法通过QSS实现，需要重写，里面的漏斗形图形需要比较多步骤去绘制。

重写QCheckBox

 void paintEvent(QPaintEvent *event) override
    {
        QCheckBox::paintEvent(event);
        QPainter painter(this);


        // 绘制复选框
        QStyleOptionButton opt;
        initStyleOption(&opt);

        QRect checkBoxRect = style()->subElementRect(QStyle::SE_CheckBoxIndicator, &opt, this);
        painter.setRenderHint(QPainter::Antialiasing);

        if (isChecked())
        {
            // 绘制选中时的圆角背景
            painter.setBrush(QColor("#BB9F5E"));  // 设置选中时的背景颜色
            painter.setPen(Qt::NoPen);  // 去除边框
        }
        else
        {
            // 绘制未选中时的圆角边框
            painter.setBrush(Qt::NoBrush);  // 不填充背景
            painter.setPen(QPen(QColor("#8C8C8C"), 2));  // 使用灰色边框，线宽为2
        }

        // 绘制圆角矩形，圆角半径为3
        painter.drawRoundedRect(checkBoxRect.adjusted(1, 1, -1, -1), 3, 3);

        // 如果复选框被选中，绘制白色的勾
        if (isChecked())
        {
            painter.setPen(QPen(Qt::white, 2));  // 设置勾的颜色为白色，线宽为2

            // 使用 QPainterPath 绘制勾的形状
            QPainterPath checkMarkPath;
            checkMarkPath.moveTo(checkBoxRect.left() + checkBoxRect.width() * 0.3, checkBoxRect.center().y());
            checkMarkPath.lineTo(checkBoxRect.center().x()-2, checkBoxRect.bottom() - checkBoxRect.height() * 0.3);
            checkMarkPath.lineTo(checkBoxRect.right() - checkBoxRect.width() * 0.3, checkBoxRect.top() + checkBoxRect.height() * 0.35);
            painter.drawPath(checkMarkPath);  // 绘制勾
        }

    }

重写QRadioButton

  void paintEvent(QPaintEvent* event) override
    {

          QPainter painter(this);
          painter.setRenderHint(QPainter::Antialiasing);

          QStyleOptionButton option;
          initStyleOption(&option);
          painter.save();
  
  
  
          // 获取单选框的矩形区域
          QRect radioButtonRect = style()->subElementRect(QStyle::SE_RadioButtonIndicator, &option, this);
  
          // 增大单选框的尺寸
          int enlargedSize = 24;  // 自定义单选框的大小（增大后的大小）
          radioButtonRect.setWidth(enlargedSize);
          radioButtonRect.setHeight(enlargedSize);
  
  
  
          painter.setBrush(Qt::NoBrush);  // 不填充背景
          painter.setPen(QPen(QColor("#8C8C8C"), 2));  // 使用灰色边框，线宽为2
  
          // 绘制增大的圆形的单选框
          QRect CircleRect = radioButtonRect.adjusted(2, 2, -2, -2); // 调整绘制圆形的位置
          painter.drawEllipse(circleRect);
  
          // 如果当前单选框被选中，则填充中心
          if (isChecked()) 
          {   
  
              painter.setPen(QPen(QColor("#BB9F5E"), 2));
              painter.drawEllipse(circleRect);
  
  
              painter.setBrush(QColor("#BB9F5E"));   // 设置选中时的填充颜色为白色
              painter.drawEllipse(circleRect.adjusted(5,5, -5, -5));  // 绘制小圆圈，表示选中
          }
  
          // 绘制文本，确保文本位置对齐
          QRect textRect = option.rect;
  
          // 将文本左移，使其与增大的单选框右边对齐
          textRect.setLeft(radioButtonRect.right() + 5);  // 将文本移到单选框右侧
  
          // 使文本垂直居中
          textRect.moveTop(radioButtonRect.top() + (radioButtonRect.height() - textRect.height()) / 2);
          painter.restore();
  
          // 使用默认的文本颜色（由样式表和控件状态决定）
          style()->drawItemText(&painter, textRect, Qt::AlignVCenter, option.palette, isEnabled(), option.text);
      }

绘制设置框的线条和图形。

void Setting::paintEvent(QPaintEvent*event)
{   
      QPainter p(this);
      QPen pen;
      QPainterPath path;
      pen.setColor(QColor("#CFCFCF"));//CFCFCF
      pen.setWidth(2);
      p.setPen(pen);
  
      //画顶部线条
      int x = ui->labelSetting->pos().x();
      int y = ui->labelSetting->pos().y()+ui->labelSetting->height()+10;
      p.drawLine(x,y,x+this->width()-40,y);
  
  
  
  
      //画圆弧
      int aw = 20;
      int endx = x+this->width()-35;
      int endy = y;
  
      int cx = endx-aw;
      int cy = endy-aw;
  
      int tx = cx-aw;
      int ty = cy-aw;
  
      //int bx = cx+aw;
      int by = cy+aw;
  
  
      int startAngle = 270;
      int spanAngle = 80;
      double rr = aw;
  
      int cx1 = tx+aw;
      int cy1 = ty+aw;
      double ex1 = cx1 + rr * cos((startAngle + spanAngle) * 3.14 / 180);
      double ey1 = cy1 - rr * sin((startAngle + spanAngle) * 3.14 / 180);
  
      startAngle = 90;
      spanAngle  = -80;
      int cx2 = tx+aw;
      int cy2 = by+aw;
      double ex2 = cx2 + rr * cos((startAngle + spanAngle) * 3.14 / 180);
      double ey2 = cy2 - rr * sin((startAngle + spanAngle) * 3.14 / 180);
  
  
  
      p.setBrush(QColor("#333333"));
      p.setPen(Qt::white);
      path.moveTo(cx,by);
      path.lineTo(ex1,ey1);
      path.lineTo(ex2,ey2);
      path.lineTo(cx,by);
      p.drawPath(path);
  
  
  
      path.clear();
      path.moveTo(cx,by);
      QRect r (tx,ty,aw*2,aw*2);  //x,y,width,height
      QRect r2(tx,by,aw*2,aw*2);
  
      pen.setWidth(1);
      p.setPen(pen);
      p.setRenderHint(QPainter::Antialiasing);
      path.arcTo(r,270,80);
      path.moveTo(cx,by);
      path.arcTo(r2,90,-80);
      p.fillPath(path,Qt::white);
  
  
  
      //画顶部线条
      pen.setColor(QColor("#464646"));
      pen.setWidth(2);
      p.setPen(pen);
      p.drawLine(x+this->width()-35,0,x+this->width()-35,this->height());
  
  
      //画右边线条
      int s1x = ui->btnCancel->pos().x();
      int s1y = ui->btnCancel->pos().y()-20;
      int s2x = ui->btnOk->pos().x()+ui->btnOk->width();
  
      pen.setColor(QColor("#CBCBCB"));
      pen.setWidthF(1.5);
      p.setPen(pen);
      p.drawLine(s1x,s1y,s2x,s1y);
  
  
      //画右下角三角形
      QPoint p1(x+this->width()-35,this->height()-10);
      QPoint p2(x+this->width()-35,this->height());
      QPoint p3(x+this->width()-45,this->height());
  
  
      QPolygon cons;
      cons<<p1<<p2<<p3;
      p.setPen(Qt::black);
      p.drawPolygon(cons);
  }

最终效果图就是这样。

9. 其它

除了界面之外，我们编写一下各控件对应事件就可以了，比如打开链接，跳转到网站。
完整的源码在放在GitHub里面了： GameLauncher
有玩鸣潮的可以加个好友： ID:100073367