FloatMenuSample 开源项目教程

FloatMenuSample 开源项目教程

FloatMenuSampleandroid 悬浮窗菜单，可在launcher或app中使用项目地址:https://gitcode.com/gh_mirrors/fl/FloatMenuSample

项目介绍

FloatMenuSample 是一个 Android 悬浮窗菜单库，可以在 launcher 或 app 中使用。该项目允许开发者轻松地在应用中集成悬浮窗菜单，提供了一种便捷的用户交互方式。悬浮窗菜单可以显示在应用的任何界面之上，适用于需要快速访问特定功能或设置的场景。

项目快速启动

添加依赖

首先，在您的 Android 项目的 build.gradle 文件中添加以下依赖：

implementation 'com.yw.game.floatmenu:FloatMenu:2.0.0'

初始化悬浮窗菜单

在您的 Activity 中初始化悬浮窗菜单：

import com.yw.game.floatmenu.FloatLogoMenu;
import com.yw.game.floatmenu.FloatMenuView;

public class MainActivity extends AppCompatActivity {
    private FloatLogoMenu mFloatMenu;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        List<FloatMenuItem> itemList = new ArrayList<>();
        itemList.add(new FloatMenuItem(R.drawable.ic_menu_item1, "Item 1"));
        itemList.add(new FloatMenuItem(R.drawable.ic_menu_item2, "Item 2"));

        mFloatMenu = new FloatLogoMenu.Builder()
            .withActivity(this)
            .logo(R.drawable.yw_image_float_logo)
            .backMenuColor(0xffe4e3e1)
            .drawCicleMenuBg(true)
            .setFloatItems(itemList)
            .defaultLocation(FloatLogoMenu.RIGHT)
            .drawRedPointNum(false)
            .showWithListener(new FloatMenuView.OnMenuClickListener() {
                @Override
                public void onItemClick(int position, String title) {
                    Toast.makeText(MainActivity.this, "position " + position + " title:" + title + " is clicked", Toast.LENGTH_SHORT).show();
                }

                @Override
                public void dismiss() {
                    // Handle dismiss event
                }
            })
            .build();
    }
}

权限设置

如果需要在桌面显示悬浮窗，请确保在 AndroidManifest.xml 中添加以下权限：

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

应用案例和最佳实践

应用案例

FloatMenuSample 可以用于多种场景，例如：

• 快速设置菜单：在应用中提供一个悬浮窗菜单，用户可以快速访问常用的设置选项。
• 工具栏：在游戏应用中，悬浮窗菜单可以作为工具栏，提供快速访问游戏内工具的功能。

最佳实践

• 合理设计菜单项：确保菜单项的数量适中，避免过多选项导致用户选择困难。
• 视觉一致性：保持悬浮窗菜单的视觉风格与应用整体设计一致，提升用户体验。

典型生态项目

FloatMenuSample 可以与其他 Android 开源项目结合使用，例如：

• EventBus：用于处理悬浮窗菜单项点击事件的通信。
• RxJava：用于处理异步任务和数据流，提升应用性能。
• ButterKnife：用于简化视图绑定和事件处理。

通过结合这些生态项目，可以进一步提升 FloatMenuSample 的功能和性能，为用户提供更加丰富和流畅的体验。

FloatMenuSampleandroid 悬浮窗菜单，可在launcher或app中使用项目地址:https://gitcode.com/gh_mirrors/fl/FloatMenuSample