Qt内部的d指针和q指针:Q_DECLARE_PRIVATE是干嘛的

最新推荐文章于 2024-06-02 19:34:17 发布
最新推荐文章于 2024-06-02 19:34:17 发布
阅读量2.2k 收藏 28
点赞数 7
分类专栏： Qt及C++应用 文章标签： c++ 开发语言 D指针 QT：D_D Q_DECLARE_
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_40583088/article/details/126932083
版权

Q_DECLARE_PRIVATE是干嘛的

        Q_DECLARE_PRIVATE就是实现Qt内部的d指针和q指针的功能宏命令。如果想了解具体的使用与内部信息我们就得了解Qt内部的d指针和q指针

Qt内部的d指针和q指针

        Qt内部的d指针和q指针是保证模块间的二进制兼容。也就是如果我们使用插件式开发项目，调用静态/动态库时，保证库的开发版本变化，仍然可以正常调用工作的技术，我们称之为二进制兼容。

二进制兼容性

        二进制兼容简单说就是如果自己的项目调用了开发好的库，二进制兼容可以保证在升级了库文件后（比如XX.lib从1.0升级到2.0），自己的项目可以不用重新编译就能够兼容修改后的XX.lib 2.0。 二进制指的是编译生成的库文件，一旦编译好的库文件，其内部内存布局是固定的，如果我们想调用库文件里的对象、或是变量，其实就是利用偏移寻址找到我们想调用的东西。当我们第一次编译项目时(整个项目完全编译)，项目是知道我们调用的XX.lib的内存布局的。如果，我们不编译我们的主项目程序，只是升级了xx.lib库版本，在xx.lib中我们添加了变量或其他数据项(静态数据除外)，很显然，xx.lib的内存布局发生了变化。这时我们的项目主体程序(调用者)还不知道xx.lib内存布局发生了变化，一旦项目主体程序(调用者)调用xx.lib中的数据，想当然的就会发生错误导致崩溃。

这是摘抄至 KDE Community Wiki (这个博客详细介绍了二进制兼容性，有兴趣的朋友可以详细研究一下)的一段话：

二进制兼容：如果动态链接到库的旧版本的程序继续使用库的新版本运行，而不需要重新编译，则库是二进制兼容的。如

源代码兼容：果程序需要重新编译才能使用新版本的库运行，但不需要任何进一步修改，则该库是源代码兼容的。

        二进制兼容性节省了很多麻烦。它使得为某个平台分发软件变得更加容易。如果不确保版本之间的二进制兼容性，人们将被迫提供静态链接的二进制文件。

静态二进制文件有很大的缺点，因为它们：

 
  • 浪费资源（尤其是内存）
  • 不允许程序从库中的错误修复或扩展中获益

        在KDE项目中，我们将在核心库（KDELIB、KDEPIMLIB）的主要版本的生命周期内提供二进制兼容性。

        这里是会对二进制兼容破坏的操作(这里仅仅列出了数据成员的破坏操作，对函数的改动等都会破坏二进制的兼容性，这里我们能够理解就可以了。)：

  • 将新的数据成员添加到现有的类
  • 改变一个类中的非静态数据成员的顺序
  • 修改成员的类型，修改符号例外 （例如：signed/unsigned 改来改去，不影响字节长度）
  • 从现有的类中删除现有的非静态数据成员

我在国内的很多博客里看到：“调整私有成员变量的顺序会造成二进制不兼容”，“私有成员是二进制兼容的大敌”。对于这两句话我没有找到有用的证据证明这一点。对二进制兼容的破坏是多样性的。没有任何证据显示私有成员的特别性。这个话题有待论证？

 理解Qt内部的d指针和q指针的原理

        首先我们关心的是二进制兼容性问题，并不去理会Qt内部的d指针和q指针，因为它只是QT解决兼容性问题的解决方案。在C++中解决二进制兼容性的方案在不同的框架中都有不同的实现方式，但是原理是一样的。

        在了解指针的情况下，很当然的我们会想到利用指针去解决二进制兼容问题。因为我们只用在插件(库文件xx.lib)中声明一个指向外部的指针。无论我们的对指针指向的数据怎样变化，存储指针的内存顺序和空间是不会变化的。指针指向外部的结构体其实就在插件库中，当我们更新了插件库，那指针所指向的外部也属于插件库的一部分，当然也更新了。这样就很好的避开了二进制兼容的陷阱。

        我们利用上一段的推理去实现这种方案。假设我们有一个播放器，我们需要实现播放列表。这个播放列表我们希望它以插件(动态链接库)的方式调用。

QMediaPlaylist.h

#ifndef QMEDIAPLAYLIST_H
#define QMEDIAPLAYLIST_H

#include <QWidget>
#include "QMediaPlaylistPrivate.h"

class QMediaPlaylistPrivate;

class QMediaPlaylist : public QWidget
{
    Q_OBJECT

public:
    QMediaPlaylist(QWidget *parent = nullptr):d_ptr(new QMediaPlaylistPrivate){ d_ptr->q_ptr = this; }
    ~QMediaPlaylist(){ if(d_ptr);

    //这里很多大牛举的例子采用了内联方式声明函数，这样更能明显的显露二进制兼容的陷阱
    void setNumber(int num) { d_ptr->number = num; }
    int getNumber() { return d_ptr->number; }

protected:
    QMediaPlaylistPrivate* d_ptr = nullptr;

};
#endif // QMEDIAPLAYLIST_H

QMediaPlaylistPrivate.h代码：

#ifndef QMEDIAPLAYLISTPRIVATE_H
#define QMEDIAPLAYLISTPRIVATE_H

//有些朋友可能对这句有些疑惑，可以查询指针与前置声明
class QMediaPlaylist;

class QMediaPlaylistPrivate
{
  public:
    QMediaPlaylistPrivate(){}
    ~QMediaPlaylistPrivate(){}

    int number;
    QMediaPlaylist* q_ptr;
};

#endif // QMEDIAPLAYLISTPRIVATE_H

main.h代码（main里的UI代码不是必须的，我只是为了更好的实现。）：

#include "QMediaPlaylist.h"

#include <QApplication>
#include <QLabel>
#include <QVBoxLayout>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QMediaPlaylist w;

    w.setNumber(10);

    QLabel *label = new QLabel(&w);
    label->setText(QString::number(w.getNumber()));

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(label);
    w.setLayout(layout);
    w.setGeometry(100,100,260,100);


    w.show();
    return a.exec();
}

  在这个样例中QMediaPlaylistPrivate作为QMediaPlaylist的类，我们在改动QMediaPlaylist的时候并不会破坏QMediaPlaylist的二进制兼容性。因为我们暴漏给项目的主体程序只是QMediaPlaylist的接口，而操纵QMediaPlaylistPrivate中的数据是QMediaPlaylist利用一直没有变化的指针操作的。QMediaPlaylist相对于项目主体程序是永远没有改变内存布局的，因为它隐藏了细节。

        上面的样例看起来已经完全解决了二进制兼容性的问题。而QT给的d指针和q指针的解决方案看起来要比我们多做了更多的事情。原因在于QT考虑的更周到，考虑了系统的优化。我在鬼谷子com的博客里发现在多层继承中，最顶端的父类中QMediaPlaylistPrivate对象构造函数会多次重建，这样会造成资源的浪费。我们清楚，子类的初始化会首先调用基类的构造函数，这是一次计数。我们基类和子类都会包含D指针，这样就会再次触发基类的构造函数，这又是N次计数。这里假设我们有多次继承发生。鬼谷子com的一篇文章详细介绍了优化思路。

通过上面的理解总结D指针的好处：

  • 保证代码的二进制兼容性；
  • 隐藏实现细节；
  • 提高编译速度；
  • 优化占用资源。

再谈Qt内部的d指针和q指针

        我们在Qt中看到的两个宏Q_D和Q_Q这两个宏分别是取得d指针和q指针的，d指针指向封装的私有类，q指针指向公共的类。Q_D和Q_Q替我们封装了我们之前的思路(但，不一定会是同样的技术)。所有的细节操作由这两个宏和Objedt基类替我们做了。

理解D指针

首先看一下 Q_D 的Q_DECLARE_PRIVATE()宏定义：

#define Q_DECLARE_PRIVATE(Class) \
 inline Class##Private* d_func() { return reinterpret_cast<Class##Private *>(qGetPtrHelper(d_ptr)); } \
 inline const Class##Private* d_func() const { return reinterpret_cast<const Class##Private *>(qGetPtrHelper(d_ptr)); } \
 friend class Class##Private;

 代码中的# 和 ## 的功能分别是：

  • # 是把宏参数变成一个字符串
  • ## 是将2个宏参数连接在一起

 上面的代码替换之后就成了：

 ClassPrivate * const d = d_func()

//上面的代码就是由这个宏生成的
#define Q_D(Class) Class##Private * const d = d_func()

  d_func() 函数实际上就是返回了一个 ClassPrivate 类型的指针，在我们上面的样例中就是QMediaPlaylistPrivate指针。在样例中我们可以推导出这样的结果：

//Q_D的宏
#define Q_D(Class) Class##Private * const d = d_func()

//在我们的实例中就相当于
#define Q_D(QMediaPlaylist) QMediaPlaylistPrivate * const d = d_func()

        QMediaPlaylist 通过 Q_DECLARE_PRIVATE(QMediaPlaylist) 定义了一个 d_func() 的函数， 可以通过 d_func() 返回 QMediaPlaylistPrivat 对象的指针。

现在我们使用QT的Q_D重构之前的 QMediaPlaylist.h 代码：

#ifndef QMEDIAPLAYLIST_H
#define QMEDIAPLAYLIST_H

#include <QWidget>
#include "QMediaPlaylistPrivate.h"

class QMediaPlaylistPrivate;

class QMediaPlaylist : public QWidget
{
    Q_OBJECT

public:
    QMediaPlaylist(QWidget *parent = nullptr);
    ~QMediaPlaylist()=default;

    void setNumber(int num);
    int getNumber();

protected:
    QMediaPlaylistPrivate *d_ptr;
    Q_DECLARE_PRIVATE(QMediaPlaylist);

};
#endif // QMEDIAPLAYLIST_H

QMediaPlaylist.cpp代码：

#include "QMediaPlaylist.h"

QMediaPlaylist::QMediaPlaylist(QWidget *parent):
    QWidget(parent),
    d_ptr(new QMediaPlaylistPrivate)
{
    Q_D(QMediaPlaylist);
    d->q_ptr = this;
}

void QMediaPlaylist::setNumber(int num)
{
    d_ptr->number = num;

    //返回的指针是智能指针：QScopedPointer<QObjectData>
    Q_D(QMediaPlaylist);
    d->number = num+1;

    qDebug()<<d;      //0x1f8131c0380
    qDebug()<<d_ptr;  //0x1f8131c0380
}

int QMediaPlaylist::getNumber()
{
    return d_ptr->number;
}

至于Q_D的内部实现，可以研究一下实现源码。

理解Q指针

首先看一下Q_Q 的Q_DECLARE_PRIVATE()宏定义：

#define Q_DECLARE_PUBLIC(Class) \
 inline Class* q_func() { return static_cast<Class *>(q_ptr); } \
 inline const Class* q_func() const { return static_cast<const Class *>(q_ptr); } \
 friend class Class;

我们通过QMediaPlaylistPrivate中 q_func() 获得 QMediaPlaylist 的指针 q_ptr。而q_ptr在QMediaPlaylist构造时已经初始化。所以我们在QMediaPlaylistPrivate声明得函数内就可以调用QMediaPlaylist资源了。

下面是完整得实验代码：

main.cpp

#include "QMediaPlaylist.h"

#include <QApplication>
#include <QLabel>
#include <QVBoxLayout>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QMediaPlaylist w;

    w.setNumber(10);

    QLabel *label = new QLabel(&w);
    label->setText(QString::number(w.getNumber()));

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(label);
    w.setLayout(layout);
    w.setGeometry(100,100,260,100);


    w.show();
    return a.exec();
}
QMediaPlaylist.h
#include "QMediaPlaylist.h"

#include <QApplication>
#include <QLabel>
#include <QVBoxLayout>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QMediaPlaylist w;

    w.setNumber(10);

    QLabel *label = new QLabel(&w);
    label->setText(QString::number(w.getNumber()));

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(label);
    w.setLayout(layout);
    w.setGeometry(100,100,260,100);


    w.show();
    return a.exec();
}

QMediaPlaylist.cpp
#include "QMediaPlaylist.h"
#include "QMediaPlaylistPrivate.h"

QMediaPlaylist::QMediaPlaylist(QWidget *parent):
    QWidget(parent),
    d_ptr(new QMediaPlaylistPrivate)
{
    Q_D(QMediaPlaylist);
    d->q_ptr = this;
}

void QMediaPlaylist::setNumber(int num)
{
    d_ptr->number = num;

    //返回的指针是智能指针：QScopedPointer
    Q_D(QMediaPlaylist);
    d->number = num+1;

    qDebug()<<d;
    qDebug()<<d_ptr;
}

int QMediaPlaylist::getNumber()
{
    Q_D(QMediaPlaylist);
    d->setNumber();
    return d_ptr->number;
}

QMediaPlaylistPrivate.h
#include "QMediaPlaylist.h"
#include "QMediaPlaylistPrivate.h"

QMediaPlaylist::QMediaPlaylist(QWidget *parent):
    QWidget(parent),
    d_ptr(new QMediaPlaylistPrivate)
{
    Q_D(QMediaPlaylist);
    d->q_ptr = this;
}

void QMediaPlaylist::setNumber(int num)
{
    d_ptr->number = num;

    //返回的指针是智能指针：QScopedPointer
    Q_D(QMediaPlaylist);
    d->number = num+1;

    qDebug()<<d;
    qDebug()<<d_ptr;
}

int QMediaPlaylist::getNumber()
{
    Q_D(QMediaPlaylist);
    d->setNumber();
    return d_ptr->number;
}

QMediaPlaylistPrivate.cpp
#include "QMediaPlaylistPrivate.h"


QMediaPlaylistPrivate::QMediaPlaylistPrivate()
{
    this->number=0;
}


void QMediaPlaylistPrivate::setNumber()
{
    Q_Q(QMediaPlaylist);
    q->setNumber(100);
}

运行结果：

 

开软古剑楠
关注
  • 7
    点赞
  • 踩
  • 28
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 2
    评论
专栏目录
Qt ： d指针和q指针？
Mr.Sugarcane
06-20 2916
在Qt的源码中，我们看到大量的Q_D() 和Q_P() 宏的调用，查看代码时在一定程度上增加了复杂度。先看看两个宏的原型： #define Q_D(Class) Class##Private * const d = d_func() #define Q_Q(Class) Class * const q = q_func() ...
QT宏详解Q_OBJECT、Q_PROPERTY、Q_CLASSINFO、Q_ENUM、SIGNAL、SLOT、Q_FOREACH、Q_DECLARE_INTERFACE
啊渊的专栏
10-27 400
Q_PROPERTY是Qt中用于声明对象属性的宏。它允许在C++类中定义属性，使得这些属性能够被Qt的元对象系统（Meta-Object System）识别。通过使用Q_PROPERTY宏，你可以将C++类的属性（成员变量）暴露给Qt的元对象系统，从而实现属性的动态查询、修改和通知。是 Qt 中用于将用户自定义数据类型（非 Qt 内置类型）注册到元对象系统的宏。通常，Qt 提供的信号与槽机制、属性系统等功能是基于元对象系统实现的。
Qt之q指针（Q_Q）d指针（Q_D）源码剖析---源码面前了无秘密
fearless_ryf的博客
02-01 1463
在使用Qt的过程都会听到或遇到神秘的d指针(Q_D)、q指针(Q_Q)，接下来通过剖析Qt源，弄清楚他们工作原理。
D指针/Q指针在C++中的使用（配合本人同名博客使用）
03-09
请先看博客 http://blog.csdn.net/haoxinhaoxin/article/details/79473930 以决定是否需要下载该资源
Qt 的 d_ptr (d-pointer) 和 q_ptr (q-pointer)解析；Q_D和Q_Q指针
最新发布
zxf347085420的博客
06-02 1132
一方面，Qt在公类中定义了一个指针d_ptr指向私类，在宏Q_DECLARE_PRIVATE中定义了一个函数获取这个指针，用宏Q_D将这个指针重新命名为d，以便于访问私类对象。另一方面，Qt在私类中定义了一个指针q_ptr指向公类，在宏Q_DECLARE_PUBLIC中定义了一个函数获取这个指针，用宏Q_Q将这个指针重新命名为q，以便于访问公类对象。此时，就需要用到Qt定义的4个宏：Q_DECLARE_PRIVATE与Q_DECLARE_PUBLIC、Q_D和Q_Q。Qt中大量使用Q_D和Q_Q。
Qt中的Q_D宏和d指针
dimaoya9046的博客
07-08 804
1 _ZTS7QObject 一、Q_D的在文件中的提法 　　Q_D的设置意在方便地获取私有类指针，文件为qglobal.h。下面的##是宏定义的连字符。假设类名是A，那么A##Private翻译过来就是APrivate。 1 #define Q_D(Class) Class##Private * const d = d_func() 　　d_func()函...
QT宏: Q_DECLARE_PRIVATE与Q_DECLARE_PUBLIC(d指针 \ p指针) 及其优化使用Q_Q宏和Q_D宏
Rainbow
07-24 4995
文章目录Q_DECLARE_PRIVATE与Q_DECLARE_PUBLIC核心d指针二进制兼容性 binary compatible源码兼容Source compatible Q_DECLARE_PRIVATE与Q_DECLARE_PUBLIC https://blog.csdn.net/zhu_xz/article/details/6035861 https://blog.csdn.net/mznewfacer/article/details/6976293 宏定义在 QtGlobal(即qglobal
学习记录-Qt中使用Q指针和D指针
limilie的专栏
11-10 4239
  总结网上看到的文章，使用D指针的好处如下： 1.保证代码的二进制兼容性； 2.隐藏实现细节； 3.提高编译速度； Qt关于D指针和Q指针的定义： d_ptr指针指向私有实现类，使用如下宏定义辅助函数和声明友元类 #define Q_DECLARE_PRIVATE(Class) /       inline Class##Private* d_func() { return re...
Q_DECLARE_PRIVATE与Q_DECLARE_PUBLIC
liyong2688的专栏
01-04 1万+
Q_DECLARE_PRIVATE与Q_DECLARE_PUBLIC 这两个宏在Qt的源码中随处可见，重要性不言而喻。在 部落格的 Inside Qt Series 系列文章中，他用了3篇文章来讲这个问题。 因为 QObject 本身比较复杂，这两个宏和一个复杂的东西搅和到一块，还真是不好理解。不过幸好，这个两个宏和QObject 没有必然的联系。故接下来，忘记 QOb
Q_DECLARE_PRIVATE、Q_DISABLE_COPY、Q_PRIVATE_SLOT都是什么东西
06-13
这是一个关于Qt框架的问题，Q_DECLARE_PRIVATE、Q_DISABLE_COPY、Q_PRIVATE_SLOT都是用于实现类的封装和保护的宏定义。 Q_DECLARE_PRIVATE宏定义在类的私有声明中使用，它会自动生成一个私有类指针并声明一个私有类...
Qt应用Q/D指针
c0co24的博客
11-24 1057
目录Qt应用Q/D指针由来：应用：1. 首先定义两个宏：2. 编写头文件3. 编写实现文件 Qt应用Q/D指针 本文主要介绍如何使用Qt的Q指针和D指针，并开发一个可拖拽的QWidget作为示例 由来： 我们在Qt源码中经常可以看到Q_D/Q_Q这样的宏，这两个宏的作用是什么呢，主要有两方面用途： 信息隐藏：把类头文件中的私有数据成员和方法隐藏起来，只暴露用户需要的接口 二进制兼容：如果程序从一个以前版本的库动态链接到新版本的库之后，能够继续正常运行，而不需要重新编译，那么我们就说这个库是二进制兼容的。
qt源码级private私有绑定类 以及 q_ptr指针 和 d指针 实现
08-23
qt源码级private私有绑定类 以及 q_ptr指针 和 d指针 实现
Qt中使用Q指针和D指针
草莓蛋糕人
08-07 1702
总结网上看到的文章，使用D指针的好处如下： 1.保证代码的二进制兼容性； 2.隐藏实现细节； 3.提高编译速度； Qt关于D指针和Q指针的定义： d_ptr指针指向私有实现类，使用如下宏定义辅助函数和声明友元类 #defineQ_DECLARE_PRIVATE(Class)/ inlineClass##Private*d_func(){returnreint...
Q_DECLARE_PRIVATE宏
weixin_48657573的博客
05-08 370
相信大家在看源码的时候一定碰到过这个宏，它的用法inlined_funcreturn;;一般是在类的私有部分然后用宏去包含这个类，这样的话就有一个d_ptr指针就指向了这个QPianter类，这个d_ptr指针就可以操作QPainter的成员变量以及成员函数了。
【Qt】Qt源码学习（一）：Q_D和Q_Q，简称d指针
weixin_44399394的博客
11-21 2898
参考博客： Qt Creator 源码学习 07：D 指针 通过QtCreator源码学习Qt（十二）：Q_D和Q_Q指针 Q_D和Q_Q指针（d指针）简介 Qt的d指针主要的采用了Pimpl机制。 （不熟悉Pimpl机制可先了解一下，链接: Pimpl机制.) 用Qt文档中对于d指针的描述是这样的： The Q_D and Q_Q macros are part of a design pattern called the d-pointer (also called the opaque pointe
《QT从基础到进阶·三十二》Q指针和D指针用法
cs1395293598的博客
11-16 320
d指针是在主类中使用的，主类获取私有类或类中私有变量的指针 q指针是在私有数据类中使用的，来获取主类对象指针 Q_DECLARE_PRIVATE： MyClass能访问MyClassPrivate类中私有成员变量。Q_DISABLE_COPY： 防止D指针d_ptr二次释放。
q、d指针详解
Dramer
03-24 2391
d、q指针的初始化d、q指针的使用d、q指针的优势 d、q指针的初始化   以Qt中最常用的控件qlabe类的源码为例，研究Qt中Q_D指针的使用。   顾名思义，private代表私有的，QLabelPrivate也正如它的命名一样，其主要用于保存QLabel的私有成员以及函数。源码如下所示： class Q_AUTOTEST_EXPORT QLabelPrivate : public QFramePrivate { public: QLabelPrivate(); ~QLabelPr.
Qt之美（一）：D指针/私有实现
热门推荐
Xizhi Zhu的博客
11-25 2万+
Qt之美系列文章，和大家分享Qt的一切！
模板类支持Q_OBJECT宏吗
04-01
模板类可以支持Q_OBJECT宏，但是需要满足以下条件： 1. 模板类必须是QObject的子类。 2. 模板参数必须是可实例化的类型，不能是抽象类或未定义的类型。 3. 模板类必须在头文件中声明和实现，不可以分别在不同的文件中。 示例代码： ```c++ template<typename T> class MyObject : public QObject { Q_OBJECT public: MyObject(QObject *parent = nullptr) : QObject(parent) {} signals: void mySignal(T value); public slots: void mySlot(T value) { emit mySignal(value); } }; ``` 在使用模板类时，需要使用模板参数来实例化类： ```c++ MyObject<int> obj; connect(&obj, &MyObject<int>::mySignal, this, &MyClass::mySlot); ``` 注意：在使用模板类时，需要在头文件中包含QObject和Q_OBJECT宏的定义。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

开软古剑楠

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值