<think>
我们正在讨论
Qt for Android开发中设置
全屏的方法。用户特别提到
Android 14系统。
根据引用[1]：我们可以通过修改
AndroidManifest.xml文件来设置横屏和
全屏。但用户的需求是设置
全屏，不一定是横屏。
另外，引用[2]中提到了屏幕方向（screenOrientation）的设置，但用户主要关心
全屏设置。
在
Android开发中，设置
全屏通常意味着隐藏状态栏和导航栏，使应用占据整个屏幕。在
Qt中，我们可以通过两种方式
实现：
1. 通过修改
AndroidManifest.xml文件，设置Activity的主题为
全屏主题。
2. 在
Qt代码中使用Java Native Interface (JNI)调用
Android的
全屏API。
由于用户提到
AndroidManifest.xml的方法，并且是针对
Qt的，我们首先考虑第一种方法。
步骤：
a) 在
Qt项目中，找到或创建
AndroidManifest.xml文件。通常，
Qt会提供一个
默认的，但我们需要自定义。
b) 在
AndroidManifest.xml中，为Activity设置一个
全屏主题。通常，我们可以使用`@
android:style/Theme.NoTitleBar.Fullscreen`或类似的主题。
c) 将修改后的
AndroidManifest.xml文件放在项目中，并在.pro文件中指定其路径，如引用[1]所示：`
ANDROID_PACKAGE_SOURCE_DIR = $$PWD/your_path_to_
AndroidManifest.xml`
但是，注意：
Android 14可能会有一些新的要求或变化，因此我们需要确保主题兼容。
第二种方法：在
Qt代码中通过JNI调用
Android的
全屏方法。这种方法可以在运行时
动态设置
全屏。
示例代码（在
Qt的C++中调用）：
```cpp
#ifdef Q_OS_
ANDROID
#include <Q
AndroidJniObject>
#include <
QtAndroid>
void setFullScreen()
{
Q
AndroidJniObject activity =
QtAndroid::
androidActivity();
if (activity.isValid()) {
Q
AndroidJniObject window = activity.callObjectMethod("getWindow", "()L
android/view/Window;");
if (window.isValid()) {
// 在
Android中，
全屏设置通常通过设置窗口的标志位
实现
// 使用FLAG_FULLSCREEN隐藏状态栏，使用FLAG_LAYOUT_NO_LIMITS让内容延伸到状态栏区域（但可能需要其他标志来隐藏导航栏）
int flags = Q
AndroidJniObject::getStaticField<int>("
android/view/WindowManager$LayoutParams", "FLAG_FULLSCREEN");
// 或者使用SYSTEM_UI_FLAG_IMMERSIVE_STICKY等标志来
实现沉浸式
全屏（
Android 4.4及以上）
// 这里我们使用View的setSystemUiVisibility方法，但需要先获取当前视图
// 另一种方式：直接设置窗口的标志位
window.callMethod<void>("addFlags", "(I)V", flags);
// 注意：直接使用addFlags可能会覆盖之前的标志，更好的做法是先获取当前标志然后或操作，但这里简单示例
}
}
}
#endif
```
然而，对于隐藏导航栏（即底部虚拟按键栏），我们需要设置额外的标志。在
Android 4.0及以上，推荐使用沉浸式
全屏。
更现代的方法是使用`View.SYSTEM_UI_FLAG_FULLSCREEN`、`View.SYSTEM_UI_FLAG_HIDE_NAVIGATION`和`View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY`等标志。我们可以通过JNI调用当前视图的setSystemUiVisibility方法。
示例代码（设置沉浸式
全屏）：
```cpp
#ifdef Q_OS_
ANDROID
#include <Q
AndroidJniObject>
#include <
QtAndroid>
void setImmersiveFullScreen()
{
QtAndroid::runOn
AndroidThread([]{
Q
AndroidJniObject activity =
QtAndroid::
androidActivity();
if (activity.isValid()) {
Q
AndroidJniObject window = activity.callObjectMethod("getWindow", "()L
android/view/Window;");
if (window.isValid()) {
Q
AndroidJniObject decorView = window.callObjectMethod("getDecorView", "()L
android/view/View;");
if (decorView.isValid()) {
// 设置标志位：
全屏、隐藏导航栏、沉浸式粘性模式
int flags = Q
AndroidJniObject::getStaticField<int>("
android/view/View", "SYSTEM_UI_FLAG_FULLSCREEN")
| Q
AndroidJniObject::getStaticField<int>("
android/view/View", "SYSTEM_UI_FLAG_HIDE_NAVIGATION")
| Q
AndroidJniObject::getStaticField<int>("
android/view/View", "SYSTEM_UI_FLAG_IMMERSIVE_STICKY");
decorView.callMethod<void>("setSystemUiVisibility", "(I)V", flags);
}
}
}
});
}
#endif
```
注意：沉浸式
全屏在用户滑动屏幕边缘时会暂时
显示系统栏，然后自动隐藏（粘性模式）。
另外，在
Qt中，我们也可以使用
Qt提供的API：`
Qt::WindowFlags`，比如：
```cpp
setWindowFlags(windowFlags() |
Qt::FramelessWindowHint);
```
但是，这可能会移除标题栏，但并不能保证在
Android上完全
全屏（隐藏状态栏和导航栏）。因此，在
Android上，建议使用
Android原生的方法。
结合用户的需求（
Android 14），我们应该优先考虑使用JNI的方式设置沉浸式
全屏，因为它更灵活，且能适应不同的
Android版本。
同时，我们也可以结合修改
AndroidManifest.xml的方式，设置一个
全屏主题作为基础。
总结步骤：
方法1（修改
AndroidManifest.xml）：
1. 在项目目录下创建
android目录（如果不存在），将
默认的
AndroidManifest.xml复制到该目录下并修改。
2. 在Activity标签内，设置主题为
全屏主题，例如：
<activity
android:name="org.
qtproject.
qt5.
android.bindings.
QtActivity"
android:theme="@
android:style/Theme.Black.NoTitleBar.Fullscreen">
3. 在.pro文件中添加：
ANDROID_PACKAGE_SOURCE_DIR = $$PWD/
android
方法2（JNI
动态设置）：
1. 在
Qt中创建一个函数（如上所示）来设置沉浸式
全屏。
2. 在程序启动后（比如在main.cpp中）调用该函数。
注意：两种方法可以同时使用，以确保
全屏效果。
针对
Android 14的特别注意事项：由于
Android版本更新，权限和API可能会有变化，建议测试在
Android 14设备上的效果。另外，沉浸式
全屏在
Android 4.4（API 19）及以上可用。
最后，用户可以根据需要选择其中一种方法，或者同时使用。
相关问题：
1. 在
Qt for Android中，如何隐藏状态栏但保留导航栏？
2.
Qt for Android开发中，如何处理
全屏模式下的系统手势导航？
3. 除了
全屏设置，如何调整
Qt Android应用的屏幕方向（横屏/竖屏）？
</think>
在
Qt for Android开发中设置
全屏显示（针对
Android 14系统），可通过以下两种核心方法
实现：
### 方法1：修改
AndroidManifest.xml（推荐）
1. **定位文件**
找到
Qt编译生成的`
AndroidManifest.xml`（通常在`build-*`目录或`
android`子目录）
2. **修改Activity属性**
在`<activity>`标签中添加
全屏主题和屏幕方向属性：
```xml
<activity
android:name="org.
qtproject.
qt5.
android.bindings.
QtActivity"
android:theme="@
android:style/Theme.Black.NoTitleBar.Fullscreen"
android:screenOrientation="fullSensor" >
```
- `Theme.Black.NoTitleBar.Fullscreen`：系统级
全屏主题（隐藏状态栏/标题栏）[^1]
- `fullSensor`：允许自动旋转（如需固定横屏用`sensorLandscape`）
3. **集成到
Qt项目**
在.pro文件中指定自定义清单路径：
```qmake
ANDROID_PACKAGE_SOURCE_DIR = $$PWD/
android
```
将修改后的`
AndroidManifest.xml`放入项目`
android`目录[^1]
### 方法2：JNI
动态设置（代码控制）
在
QML/C++中通过JNI调用
Android API：
```cpp
#include <
QtAndroid>
void setFullScreen() {
QtAndroid::runOn
AndroidThread([]{
Q
AndroidJniObject activity =
QtAndroid::
androidActivity();
Q
AndroidJniObject window = activity.callObjectMethod("getWindow", "()L
android/view/Window;");
// 启用
全屏标志（隐藏状态栏和导航栏）
const int FLAG_FULLSCREEN = 0x00000400; // WindowManager.LayoutParams.FLAG_FULLSCREEN
window.callMethod<void>("addFlags", "(I)V", FLAG_FULLSCREEN);
//
Android 14沉浸模式扩展
Q
AndroidJniObject decorView = window.callObjectMethod("getDecorView", "()L
android/view/View;");
int uiOptions = Q
AndroidJniObject::getStaticField<int>("
android/view/View",
"SYSTEM_UI_FLAG_HIDE_NAVIGATION|SYSTEM_UI_FLAG_FULLSCREEN");
decorView.callMethod<void>("setSystemUiVisibility", "(I)V", uiOptions);
});
}
```
在`main.cpp`初始化后调用`setFullScreen()`
### 关键注意事项（
Android 14）
1. **权限声明**
在`
AndroidManifest.xml`中添加
全屏所需权限：
```xml
<uses-permission
android:name="
android.permission.WRITE_SETTINGS"/>
```
2. **边缘手势处理**
全屏时需重写`onWindowFocusChanged()`处理系统手势：
```java
// Java扩展类中
@Override
public void onWindowFocusChanged(boolean hasFocus) {
super.onWindowFocusChanged(hasFocus);
if(hasFocus) setImmersiveMode();
}
```
3. **
Qt版本兼容性**
Qt 5.15+
默认支持
Android 13/14，低版本需升级NDK到r25+并配置`
android:targetSdkVersion=34`
> **验证方法**：部署后观察应用是否覆盖状态栏，调用`
QtAndroid::
androidActivity().callMethod<jint>("getWindow", "()L
android/view/Window;")`检查标志位[^2]
超级会员免费看
本文介绍了如何在Qt for Android应用中实现动态全屏和非全屏显示。针对Qt UI与Java线程不一致导致的问题，通过Java的Handler刷新UI线程来设置全屏。详细探讨了Android的setSystemUiVisibility方法，包括SYSTEM_UI_FLAG_LOW_PROFILE、SYSTEM_UI_FLAG_HIDE_NAVIGATION、SYSTEM_UI_FLAG_FULLSCREEN等标志的用途和效果。并提供了Qt调用Java实现全屏的代码示例。
订阅专栏 解锁全文
扫一扫
5134
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
