---
# System prepended metadata

title: PDFReader Android Eventbar System Design

---

# PDFReader Android Eventbar System Design

## 1. 目的
在 PDFReader Viewer 介面中加入一 eventbar，如[此簡報畫面](https://docs.google.com/presentation/d/1OY3wQ4ekNL9nsZQ5qqLmu_JYrGPtfg1kcAg9hMRZdB0/edit#slide=id.g168de558256_0_3)中，viewer 介面上方藍色 bar

在有行銷活動時，透過 remote config 顯示此 bar，並指定其內容，達到免更新 app 的活動行銷設定

此設計方式類似首頁卡片，但經產品團隊討論後，認為 viewer 畫面更能讓用乎看到，因此加入 eventbar 遠端控制系統


## 2. User Story
1. 我是一個 Kdan 系統操作者(RD, PM, MKT ...), 我可以從 [remote config](https://console.firebase.google.com/u/0/project/infinite-maxim-827/config) 設定 paramters，完成活動之 eventbar 設定，以靈活建立活動宣傳。
2. 我是一個 PDFReader App 用戶, 在沒有 D365 付費權限狀況下，於活動期間，當我在 viewer 畫面時，會看到畫面上方有一個 eventbar，我可以點擊這個 eventbar 進入特殊活動網站，讓我可以參與這個特殊活動。
3. 我是一個 PDFReader App 用戶, 在沒有 D365 付費權限狀況下，於活動期間，當我在 viewer 畫面時，會看到畫面上方有一個 eventbar，我可以關閉 eventbar 並設定之後不再顯示，讓我不再受到干擾。


## 3. 規格
### UI
* 請參照 [zepline](https://app.zeplin.io/project/5d22f83176cacb3757c3760b?seid=635b870738f4c430c0c1b0a3)
* [UI 遠端控制項目說明 PDF](http://pms.kdan.cc:24373/attachments/4377)
### Flow chart
[![](https://mermaid.ink/img/pako:eNqdU8lOwzAQ_ZWRL6VSOdAChx5ANCk3FolFgoaD4wyN1cSO7AkBNf13HKehAYFU4VMyfss8j71mQifIpmxpeJHCfRipSIFbtozbEr6hIoi5AakIDRck9RbTrNnRwiM8wMKbtDLO8AUOD8_qB4sGgkyKFXxhCN-phtn44KZABRXGEBtdNcBKUuOmkKA02fD_FiLTFiEuibRyVpODu1RX2xyJ5Jle9sUnOx3hdVrIT5XjReALod992UMguL_Y0cc9wvGOkHILIkWxwgQGoVYDAts0S6kLypdcqoEjnyx6Q7BuDt0R_C2qNO0hfNQKoEp-H3tj6L1kJulj53bRTu82vIRHiRWaYeMOs7UTL0ojXAfON5ycnpxvej36Fq91DcHax4C5j0Uyxz4u8LgntDWEDbDL8WuMPjHcGkA9783chRh-y9llZSOWo8m5TNz9Xze1iFGKOUZs6j4TblYRi9TG4coi4YTzRJI2bEqmxBHjJem7DyW6_xbj7oc7wJxNX3lmXRU956p9ZP6tjVjB1bPWHWbzCWT9IzA?type=png)](https://mermaid.live/edit#pako:eNqdU8lOwzAQ_ZWRL6VSOdAChx5ANCk3FolFgoaD4wyN1cSO7AkBNf13HKehAYFU4VMyfss8j71mQifIpmxpeJHCfRipSIFbtozbEr6hIoi5AakIDRck9RbTrNnRwiM8wMKbtDLO8AUOD8_qB4sGgkyKFXxhCN-phtn44KZABRXGEBtdNcBKUuOmkKA02fD_FiLTFiEuibRyVpODu1RX2xyJ5Jle9sUnOx3hdVrIT5XjReALod992UMguL_Y0cc9wvGOkHILIkWxwgQGoVYDAts0S6kLypdcqoEjnyx6Q7BuDt0R_C2qNO0hfNQKoEp-H3tj6L1kJulj53bRTu82vIRHiRWaYeMOs7UTL0ojXAfON5ycnpxvej36Fq91DcHax4C5j0Uyxz4u8LgntDWEDbDL8WuMPjHcGkA9783chRh-y9llZSOWo8m5TNz9Xze1iFGKOUZs6j4TblYRi9TG4coi4YTzRJI2bEqmxBHjJem7DyW6_xbj7oc7wJxNX3lmXRU956p9ZP6tjVjB1bPWHWbzCWT9IzA)


### Remote Config

#### 可 remote config 更換之項目
1. 顯示 eventbar 時間
    1. 開始時間
    2. 結束時間
2. eventbar
    1. 左側 icon url(尺寸固定)
    2. 左側 icon 顯示/隱藏
    3. 文字
    4. 文字顏色
    5. 文字點擊後開啟之連結
    6. 右側關閉用的 button icon url(尺寸固定)
    7. 右側關閉用的 button 顯示/隱藏
    8. 背景色
3.  dialog
    1. 中間圖片 url(尺寸固定)
    2. 右上角關閉用的 button icon url(尺寸固定)
    3. 右上角關閉用的 butoon 顯示/隱藏
    4. 中間文字
    5. 中間文字顏色
    7. 中間按鈕1文字
    8. 中間按鈕1文字顏色
    9. 中間按鈕1顏色
    10. 中間按鈕1點擊後開啟連結
    11. 中間按鈕2文字
    12. 中間按鈕2文字顏色
    13. 中間按鈕2顏色
    14. 中間按鈕2點擊後開啟連結
    15. 下方 Don't show this again 文字顏色
    16. 下方 Don't show this again 左側 checkbox 勾選時顏色
    17. 下方 Don't show this again 左側 checkbox 未勾選時顏色
    18. 下方 Don't show this again 顯示/隱藏(包含方塊與文字)
    19. 背景色

#### Remote config 參數
* 僅一個 parameter
* parameter name -> **viewer_eventbar_config**
* 以 json 方式寫入
* eventName 用於 SP 儲存之 key name(記錄該次活動用戶是否已勾選不再顯示)
* dialogButton 為 0 - 2 個，0 個時不顯示 button
* targetUser - 指定的用戶類型顯示
    * 0 => all
    * 1 => purchased
    * 2 => non-purchased
```jsonld
{
    "eventName": "BF2022",
    "targetUser": 3,
    "startTime": 1666841799,
    "endTime": 1666891799,
    "eventBarIconUrl": "https://123.png",
    "eventBarIconVisible": true,
    "eventBarText": {
        "en": "Digitize your signature process and enjoy the freedom of workplace mobility.",
        "zh-TW": "數位化簽名流程的專家，讓您行動辦公超便利。",
        "zh-CN": "数位化签名流程的专家，让您行动办公超便利。",
        "ja": "いつでもどこでも電子サインが可能！アプリでワークフローの管理と安全で効率的な仕事を実現します。",
        "fr": "Numérisez votre processus de signature et profitez de la liberté de la mobilité en milieu de travail.",
        "de": "Digitalisieren Sie Ihren Signaturprozess und genießen Sie die Freiheit der Arbeitsplatzmobilität.",
        "es": "Digitalice su proceso de firma y disfrute de la libertad de movilidad en el lugar de trabajo.",
        "it": "Digitalizza la tua firma e goditi la libertà della mobilità sul posto di lavoro.",
        "ru": "Оцифруйте процесс подписи и наслаждайтесь мобильностью на рабочем месте.",
        "pt": "Digitalize seu processo de assinatura e aproveite a liberdade de mobilidade no local de trabalho.",
        "ko": "서명 프로세스를 디지털화하고 업무공간 이동의 자유를 누리세요."
    },
    "eventBarTextColor": "#FF330033",
    "eventBarLinkUrl": "https://kdanmobile.com",
    "eventBarCloseButtonIconUrl": "https://closebutton.png",
    "eventBarCloseButtonVisible": true,
    "eventBarBackgroundColor": "#FF3300FF",
    "dialogBackgroundColor": "#FF003388",
    "dialogImageUrl": "https://imageurl.png",
    "dialogCloseButtonIconUrl": "https://dialogclosebutton.png",
    "dialogCloseButtonIconVisible": true,
    "dialogText": {
        "en": "Digitize your signature process and enjoy the freedom of workplace mobility.",
        "zh-TW": "數位化簽名流程的專家，讓您行動辦公超便利。",
        "zh-CN": "数位化签名流程的专家，让您行动办公超便利。",
        "ja": "いつでもどこでも電子サインが可能！アプリでワークフローの管理と安全で効率的な仕事を実現します。",
        "fr": "Numérisez votre processus de signature et profitez de la liberté de la mobilité en milieu de travail.",
        "de": "Digitalisieren Sie Ihren Signaturprozess und genießen Sie die Freiheit der Arbeitsplatzmobilität.",
        "es": "Digitalice su proceso de firma y disfrute de la libertad de movilidad en el lugar de trabajo.",
        "it": "Digitalizza la tua firma e goditi la libertà della mobilità sul posto di lavoro.",
        "ru": "Оцифруйте процесс подписи и наслаждайтесь мобильностью на рабочем месте.",
        "pt": "Digitalize seu processo de assinatura e aproveite a liberdade de mobilidade no local de trabalho.",
        "ko": "서명 프로세스를 디지털화하고 업무공간 이동의 자유를 누리세요."
    },
    "dialogTextColor": "#FFFF0033",
    "dialogButton": [
        {
            "text": {
                "en": "Digitize your signature process and enjoy the freedom of workplace mobility.",
                "zh-TW": "數位化簽名流程的專家，讓您行動辦公超便利。",
                "zh-CN": "数位化签名流程的专家，让您行动办公超便利。",
                "ja": "いつでもどこでも電子サインが可能！アプリでワークフローの管理と安全で効率的な仕事を実現します。",
                "fr": "Numérisez votre processus de signature et profitez de la liberté de la mobilité en milieu de travail.",
                "de": "Digitalisieren Sie Ihren Signaturprozess und genießen Sie die Freiheit der Arbeitsplatzmobilität.",
                "es": "Digitalice su proceso de firma y disfrute de la libertad de movilidad en el lugar de trabajo.",
                "it": "Digitalizza la tua firma e goditi la libertà della mobilità sul posto di lavoro.",
                "ru": "Оцифруйте процесс подписи и наслаждайтесь мобильностью на рабочем месте.",
                "pt": "Digitalize seu processo de assinatura e aproveite a liberdade de mobilidade no local de trabalho.",
                "ko": "서명 프로세스를 디지털화하고 업무공간 이동의 자유를 누리세요."
            },
            "textColor": "#FF000099",
            "color": "#FF99FF00",
            "linkUrl": "https://www.kdanmobile.com"
        },
        {
            "text": {
                "en": "Digitize your signature process and enjoy the freedom of workplace mobility.",
                "zh-TW": "數位化簽名流程的專家，讓您行動辦公超便利。",
                "zh-CN": "数位化签名流程的专家，让您行动办公超便利。",
                "ja": "いつでもどこでも電子サインが可能！アプリでワークフローの管理と安全で効率的な仕事を実現します。",
                "fr": "Numérisez votre processus de signature et profitez de la liberté de la mobilité en milieu de travail.",
                "de": "Digitalisieren Sie Ihren Signaturprozess und genießen Sie die Freiheit der Arbeitsplatzmobilität.",
                "es": "Digitalice su proceso de firma y disfrute de la libertad de movilidad en el lugar de trabajo.",
                "it": "Digitalizza la tua firma e goditi la libertà della mobilità sul posto di lavoro.",
                "ru": "Оцифруйте процесс подписи и наслаждайтесь мобильностью на рабочем месте.",
                "pt": "Digitalize seu processo de assinatura e aproveite a liberdade de mobilidade no local de trabalho.",
                "ko": "서명 프로세스를 디지털화하고 업무공간 이동의 자유를 누리세요."
            },
            "textColor": "#FF00FF33",
            "color": "#FF0033FF",
            "linkUrl": "https://www.kdanmobile.com"
        }
    ],
    "doNotShowTextColor": "#FF00FF00",
    "doNotShowCheckboxCheckedColor": "#FF0000FF",
    "doNotShowCheckboxUnchekcedColor": "#FFFF0000",
    "doNotShowVisible": true
}
```