Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
F

FloatingView

> 编程语言
Open source

FloatingView [Archived] Use instead: https://developer.android.com/guide/topics/ui/bubbles The Android project is View to display informati…

1.1K stars0 likes2 views
WebsiteGitHub

About

FloatingView [Archived] Use instead: https://developer.android.com/guide/topics/ui/bubbles The Android project is View to display informati…

FloatingView

[Archived] Use instead: https://developer.android.com/guide/topics/ui/bubbles

The Android project is View to display information such as chat in front. To API Level 14 or higher are supported

Screenshots

Watch YouTube video
SimpleFloating

Requirements

Target Sdk Version : 28
Min Sdk Version : 14

How to use

  1. Add this to your build.gradle.
java
repositories {
    maven {
        url "https://jitpack.io"
    }
}

dependencies {
  implementation 'com.github.recruit-lifestyle:FloatingView:2.4.4'
}
  1. Implement Service for displaying FloatingView
java
public class ChatHeadService extends Service {
  ... ...
}
  1. You will do the setting of the View to be displayed in the FloatingView(Sample have a set in onStartCommand)
java
  final LayoutInflater inflater = LayoutInflater.from(this);
  final ImageView iconView = (ImageView) inflater.inflate(R.layout.widget_chathead, null, false);
  iconView.setOnClickListener(......);
  1. Use the FloatingViewManager, make the setting of FloatingView
java
  mFloatingViewManager = new FloatingViewManager(this, this);
  mFloatingViewManager.setFixedTrashIconImage(R.drawable.ic_trash_fixed);
  mFloatingViewManager.setActionTrashIconImage(R.drawable.ic_trash_action);
  final FloatingViewManager.Options options = new FloatingViewManager.Options();
  options.overMargin = (int) (16 * metrics.density);
  mFloatingViewManager.addViewToWindow(iconView, options);

The second argument of FloatingViewManager is FloatingViewListener

Describe the process (onFinishFloatingView) that is called when you exit the FloatingView

java
    @Override
    public void onFinishFloatingView() {
        stopSelf();
    }
  1. Add the permission to AndroidManifest
xml
 
 
  1. Define the Service to AndroidManifest

example)

java
    
        ...
        
        
        ...
    
  1. Describe the process to start the Service (run on foreground)

example)

  • FloatingViewControlFragment.java
java
    final Intent intent = new Intent(activity, ChatHeadService.class);
    ContextCompat.startForegroundService(activity, intent);
  • ChatHeadService.java
java
public int onStartCommand(Intent intent, int flags, int startId) {
    ...
    startForeground(NOTIFICATION_ID, createNotification(this));
    ...
}
  1. Create notification channel (targetSdkVersion >= 26)

example)

java
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    final String channelId = getString(R.string.default_floatingview_channel_id);
    final String channelName = getString(R.string.default_floatingview_channel_name);
    final NotificationChannel defaultChannel = new NotificationChannel(channelId, channelName, NotificationManager.IMPORTANCE_MIN);
    final NotificationManager manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
    if (manager != null) {
        manager.createNotificationChannel(defaultChannel);
    }
}
  1. Add DisplayCutout process(API Level >= 28)

Call FloatingViewManager.findCutoutSafeArea(activity).
Note: Activity must be portrait oriented.
Note: You must not set windowLayoutInDisplayCutoutMode to never.

example)

  • FloatingViewControlFragment.java
java
final Intent intent = new Intent(activity, ChatHeadService.class);
intent.putExtra(ChatHeadService.EXTRA_CUTOUT_SAFE_AREA, FloatingViewManager.findCutoutSafeArea(activity));
ContextCompat.startForegroundService(activity, intent);
  • ChatHeadService.java
java
mFloatingViewManager.setSafeInsetRect((Rect) intent.getParcelableExtra(EXTRA_CUTOUT_SAFE_AREA));

Static Options

It can be set only when displaying for the first time

example)

java
final FloatingViewManager.Options options = new FloatingViewManager.Options();
options.overMargin = (int) (16 * metrics.density);
mFloatingViewManager.addViewToWindow(iconView, options);
Option Description
shape FloatingViewManager.SHAPE_CIRCLE:Circle(default)
FloatingViewManager.SHAPE_RECTANGLE:Rectangle
overMargin Margin over the edge of the screen (px)
(default) 0
floatingViewX X coordinate of initial display
(default) left side of display
floatingViewY Y coordinate of initial display
(default) top of display
floatingViewWidth FloatingView width
(default) The width of the layout added to FloatingView
floatingViewHeight FloatingView height
(default) The height of the layout added to FloatingView
moveDirection FloatingViewManager.MOVE_DIRECTION_DEFAULT:Left end or right end(default)
FloatingViewManager.MOVE_DIRECTION_LEFT:Left end
FloatingViewManager.MOVE_DIRECTION_RIGHT:Right end
FloatingViewManager.MOVE_DIRECTION_NONE:Not move
FloatingViewManager.MOVE_DIRECTION_NEAREST:Move nearest edge
FloatingViewManager.MOVE_DIRECTION_THROWN:Move in the throwing direction (left end or right end)
usePhysics Use physics-based animation(depends on moveDirection)
(default) true
Info:If MOVE_DIRECTION_NEAREST is set, nothing happens
Info:Can not be used before API 16
animateInitialMove If true, animation when first displayed
(FloatingViewX, floatingViewY) to screen edge
Info: If MOVE_DIRECTION_NONE is set, nothing happens

Dynamic Options

It can be set any time

example)

java
mFloatingViewManager.setFixedTrashIconImage(R.drawable.ic_trash_fixed);
mFloatingViewManager.setActionTrashIconImage(R.drawable.ic_trash_action);
Option Description
setFixedTrashIconImage It is an icon that does not enlarge when FloatingView overlaps.
setActionTrashIconImage It is an icon that enlarge when FloatingView overlaps.
setDisplayMode FloatingViewManager.DISPLAY_MODE_SHOW_ALWAYS:Always show
FloatingViewManager.DISPLAY_MODE_HIDE_ALWAYS:Always hidden
FloatingViewManager.DISPLAY_MODE_HIDE_FULLSCREEN:It is hidden when in full screen
setTrashViewEnabled If false, the trash icon does not show during dragging.
(default) true

Credits

FloatingView is owned and maintained by RECRUIT LIFESTYLE CO., LTD.

FloatingView was originally created by Yoshihide Sogawa

License

Copyright 2015 RECRUIT LIFESTYLE CO., LTD.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Java

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言