全屏沉浸模式ImmersiveMode

2019-11-10 18:01:38

字體：大中小

供稿：網(wǎng)友

在寫(xiě)播放器的時(shí)候，遇到了關(guān)于全屏模式的坑。翻閱了網(wǎng)上一些資料和google 官方的demo后，終于把坑填完了。

全屏主要的干擾就是頂部狀態(tài)欄stateBar和部分手機(jī)的虛擬按鍵NavigationBar。

這是google demo的源碼：

    /**     * Detects and toggles immersive mode (also known as "hidey bar" mode).     */    public void toggleHideyBar() {        // BEGIN_INCLUDE (get_current_ui_flags)        // The UI options currently enabled are rePResented by a bitfield.        // getSystemUiVisibility() gives us that bitfield.        int uiOptions = getActivity().getWindow().getDecorView().getSystemUiVisibility();        int newUiOptions = uiOptions;        // END_INCLUDE (get_current_ui_flags)        // BEGIN_INCLUDE (toggle_ui_flags)        boolean isImmersiveModeEnabled =                ((uiOptions | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY) == uiOptions);        if (isImmersiveModeEnabled) {            Log.i(TAG, "Turning immersive mode mode off. ");        } else {            Log.i(TAG, "Turning immersive mode mode on.");        }        // Navigation bar hiding:  Backwards compatible to ICS.        if (Build.VERSION.SDK_INT >= 14) {            newUiOptions ^= View.SYSTEM_UI_FLAG_HIDE_NAVIGATION;        }        // Status bar hiding: Backwards compatible to Jellybean        if (Build.VERSION.SDK_INT >= 16) {            newUiOptions ^= View.SYSTEM_UI_FLAG_FULLSCREEN;        }        // Immersive mode: Backward compatible to KitKat.        // Note that this flag doesn't do anything by itself, it only augments the behavior        // of HIDE_NAVIGATION and FLAG_FULLSCREEN.  For the purposes of this sample        // all three flags are being toggled together.        // Note that there are two immersive mode UI flags, one of which is referred to as "sticky".        // Sticky immersive mode differs in that it makes the navigation and status bars        // semi-transparent, and the UI flag does not get cleared when the user interacts with        // the screen.        if (Build.VERSION.SDK_INT >= 18) {            newUiOptions ^= View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;        }        getActivity().getWindow().getDecorView().setSystemUiVisibility(newUiOptions);        //END_INCLUDE (set_ui_flags)    }
這個(gè)demo比較簡(jiǎn)單，不做詳細(xì)的解釋。就簡(jiǎn)單的介紹下Flag等意思。
getActivity().getWindow().getDecorView() //獲取當(dāng)前頁(yè)面的跟布局。View.SYSTEM_UI_FLAG_HIDE_NAVIGATION;//控制NavigationBar的隱藏于顯示。View.SYSTEM_UI_FLAG_FULLSCREEN;//控制stateBar的隱藏與顯示。View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;這個(gè)標(biāo)簽比較有趣。其實(shí)這個(gè)標(biāo)簽有兩個(gè)：View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY 和 View.SYSTEM_UI_FLAG_IMMERSIVE。這兩個(gè)標(biāo)簽都必須和View.SYSTEM_UI_FLAG_HIDE_NAVIGATION、View.SYSTEM_UI_FLAG_FULLSCREEN 一起使用。下面分為3中情況：
1、只使用View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 和 View.SYSTEM_UI_FLAG_FULLSCREEN 。
這種情況下，在進(jìn)入全屏模式后，用戶有任何操作，SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN 就會(huì)被清除。狀態(tài)欄和虛擬按鍵會(huì)一直可見(jiàn)。除非再次設(shè)置SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN。在狀態(tài)欄和虛擬按鍵顯示變化時(shí)會(huì)調(diào)用View.OnSystemUiVisibilityChangeListener。
2、SYSTEM_UI_FLAG_IMMERSIVE 配合View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 和 View.SYSTEM_UI_FLAG_FULLSCREEN使用。
用戶操作不會(huì)清除SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN。會(huì)一直保持全屏模式。顯示切換時(shí)也會(huì)觸發(fā)View.OnSystemUiVisibilityChangeListener。還有一個(gè)區(qū)別就是 ，全屏模式時(shí)，從原本狀態(tài)欄或者虛擬按鍵的位置 響屏幕內(nèi)部滑動(dòng)，會(huì)清除SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN，保持可見(jiàn)狀態(tài)，并且也會(huì)觸發(fā)View.OnSystemUiVisibilityChangeListener監(jiān)聽(tīng)。3.SYSTEM_UI_FLAG_IMMERSIVE_STICKY配合View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 和 View.SYSTEM_UI_FLAG_FULLSCREEN使用。
用戶操作不會(huì)清除SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN。會(huì)一直保持全屏模式。顯示切換時(shí)也會(huì)觸發(fā)View.OnSystemUiVisibilityChangeListener。，全屏模式時(shí)，，從原本狀態(tài)欄或者虛擬按鍵的位置 響屏幕內(nèi)部滑動(dòng)， 狀態(tài)欄 和 虛擬按鍵欄會(huì)暫時(shí)可見(jiàn)，一段時(shí)間后自動(dòng)隱藏。與SYSTEM_UI_FLAG_IMMERSIVE 不同的是，因?yàn)槭桥R時(shí)的顯示，所以不會(huì)觸發(fā)View.OnSystemUiVisibilityChangeListener?？赡苷f(shuō)的有點(diǎn)混亂，可以參考下下面的表格。
個(gè)人覺(jué)得使用toggleHideyBar()來(lái)控制有點(diǎn)不順手，所以拆分成了showBar()和hideBar()。
    public void showBar(){        int uiOptions = getWindow().getDecorView().getSystemUiVisibility();        int newUiOptions = uiOptions;        boolean isImmersiveModeEnabled =                ((uiOptions | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY) == uiOptions);        if (isImmersiveModeEnabled) {            Log.i(TAG, "Turning immersive mode mode off. ");                        //先取 非 后再 與， 把對(duì)應(yīng)位置的1 置成0，原本為0的還是0                        if (Build.VERSION.SDK_INT >= 14) {                newUiOptions &= ~View.SYSTEM_UI_FLAG_HIDE_NAVIGATION;            }                       if (Build.VERSION.SDK_INT >= 16) {                newUiOptions &= ~View.SYSTEM_UI_FLAG_FULLSCREEN;            }                    if (Build.VERSION.SDK_INT >= 18) {                newUiOptions &= ~View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;            }            getWindow().getDecorView().setSystemUiVisibility(newUiOptions);        }    }    public void hideBar() {        // The UI options currently enabled are represented by a bitfield.        // getSystemUiVisibility() gives us that bitfield.        int uiOptions = getWindow().getDecorView().getSystemUiVisibility();        int newUiOptions = uiOptions;        boolean isImmersiveModeEnabled =                ((uiOptions | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY) == uiOptions);        if (!isImmersiveModeEnabled) {            Log.i(TAG, "Turning immersive mode mode on. ");                  if (Build.VERSION.SDK_INT >= 14) {                newUiOptions |= View.SYSTEM_UI_FLAG_HIDE_NAVIGATION;            }                     if (Build.VERSION.SDK_INT >= 16) {                newUiOptions |= View.SYSTEM_UI_FLAG_FULLSCREEN;            }            if (Build.VERSION.SDK_INT >= 18) {                newUiOptions |= View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;            }            getWindow().getDecorView().setSystemUiVisibility(newUiOptions);        }    }暫時(shí)就寫(xiě)這么多吧。