Xamarin.Android如何添加快捷设置面板开关按钮

1. 面板官方名称 #

你提到的顶部下拉快捷菜单官方名称是快速设置面板（Quick Settings Panel），其中的单个快捷按钮称为Quick Settings Tile（快速设置磁贴）。

2. 实现带图标开关按钮的步骤 #

在Xamarin.Android中添加自定义快速设置磁贴，需基于TileService类实现，具体步骤如下：

步骤1：创建TileService子类 #

新建一个继承自TileService的类，重写核心方法处理磁贴的状态更新、点击事件：

using Android.App;
using Android.Content;
using Android.Service.QuickSettings;
using Android.OS;
using Android.Graphics.Drawables;

namespace YourAppNamespace
{
    [Service(Permission = "android.permission.BIND_QUICK_SETTINGS_TILE",
             Label = "@string/quick_tile_label",
             Exported = true)]
    [IntentFilter(new[] { "android.service.quicksettings.action.QS_TILE" })]
    public class MyCustomQuickTile : TileService
    {
        private bool isEnabled = false;

        public override void OnStartListening(Intent intent)
        {
            base.OnStartListening(intent);
            // 更新磁贴初始状态
            UpdateTileState();
        }

        public override void OnClick()
        {
            base.OnClick();
            // 切换开关状态
            isEnabled = !isEnabled;
            UpdateTileState();
            
            // 此处添加点击后的业务逻辑，比如控制功能开关
        }

        private void UpdateTileState()
        {
            var tile = QsTile;
            if (tile == null) return;

            // 设置磁贴图标（使用资源文件或Drawable）
            tile.Icon = isEnabled 
                ? Resources.GetDrawable(Resource.Drawable.ic_tile_enabled, Theme) 
                : Resources.GetDrawable(Resource.Drawable.ic_tile_disabled, Theme);
            // 设置磁贴标题
            tile.Label = Resources.GetString(Resource.String.quick_tile_label);
            // 设置磁贴开关状态（Active为开启，Inactive为关闭）
            tile.State = isEnabled ? Tile.StateActive : Tile.StateInactive;
            // 提交状态更新
            tile.UpdateTile();
        }
    }
}

步骤2：配置资源与基础设置 #

• 在Resources/values/strings.xml中添加磁贴名称：

  <string name="quick_tile_label">自定义开关</string>
  

• 准备启用/禁用状态的两张图标资源，放入Resources/drawable目录。
• 确保应用目标Android版本不低于API 24（Android 7.0），这是TileService的最低支持版本。

步骤3：添加磁贴到面板 #

部署应用后，用户需手动添加磁贴：下拉快速设置面板，点击编辑按钮，找到你的自定义磁贴并拖入面板区域即可使用。

3. 关键注意事项 #

• 磁贴状态由系统管理，OnStartListening在磁贴可见时触发，OnStopListening在不可见时触发，需在这些方法中同步最新状态。
• 若需后台更新磁贴，可调用QsTile.UpdateTile()方法，但需确保持有对应权限。
• 开关样式磁贴通过Tile.State控制激活状态，系统会自动渲染开关UI。

4. 参考资料 #

可参考Android官方开发者文档中「Quick Settings」相关章节，以及Xamarin.Android官方文档中TileService类的详细说明。

内容的提问来源于stack exchange，提问作者user14369224