建立 QR code 付款快速設定方塊

「快速設定」是快速設定面板中顯示的圖塊。 使用者可以輕觸這些圖塊，快速完成週期性工作。 本文將說明如何建立自訂 QR code 的「快速設定」方塊 付款。

繼續操作之前，請務必熟悉一般的操作說明，以及 為應用程式建立自訂「快速設定」方塊的實務做法。

如要建立資訊方塊，請按照下列步驟操作：

1. 建立自訂圖示。

2. 建立並宣告 TileService。

   注意： 此時，您的自訂圖塊服務會顯示在「快速指令」面板的 「設定」選單。如果要在下拉時看到自訂動態磚，請編輯 重新排列動態磚。

3. 如要啟動 QR code 付款，請填入 onClick() 方法。長按 資訊方塊會提示使用者的「應用程式資訊」畫面。覆寫此行為 改為啟動活動來設定偏好 透過以下應用程式參加您的一項活動：<intent-filter> ACTION_QS_TILE_PREFERENCES。

   Kotlin

   import android.service.quicksettings.TileService
   
   // Called when the user taps on your tile in an active or inactive state.
   override fun onClick() {
      // Create Intent, replace MainActivity::class.java with QR Code Activity
      val intent = Intent(this, MainActivity::class.java)
      // Create PendingIntent
      val pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE)
      if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
        startActivityAndCollapse(pendingIntent)
      } else {
        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        startActivityAndCollapse(intent)
      }
   }
   

   Java

   import android.service.quicksettings.TileService;
   
   // Called when the user taps on your tile in an active or inactive state.
   @Override
   public void onClick() {
    // Create Intent, replace MainActivity.class with QR Code Activity
    Intent intent = new Intent(MyQSTileService.this, MainActivity.class);
    // Create PendingIntent
    PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE);
    if (VERSION.SDK_INT >= VERSION_CODES.UPSIDE_DOWN_CAKE) {
      startActivityAndCollapse(pendingIntent);
    } else {
      intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
      startActivityAndCollapse(intent);
    }
   }
   

4. 為了保護使用者敏感付款資訊，只執行安全動作 能夠在安全鎖定裝置上運作。

   Kotlin

   import android.service.quicksettings.TileService
   
   override fun onClick() {
      val intent = Intent(this, MainActivity::class.java)
      val pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE)
   
      // ...
   
      if (isSecure()) {
          startActivityAndCollapse(pendingIntent)
      } else {
          unlockAndRun {
              startActivityAndCollapse(pendingIntent)
          }
      }
      // ...
   }
   

   Java

   import android.service.quicksettings.TileService;
   
   @Override
   public void onClick() {
    Intent intent = new Intent(MyQSTileService.this, MainActivity.class);
    PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_IMMUTABLE);
    ...
    if (isSecure()) {
      startActivityAndCollapse(pendingIntent);
    } else {
      unlockAndRun(new Runnable() {
        @Override
        public void run() {
          startActivityAndCollapse(pendingIntent);
        }
      });
     }
    ...
   }
   

5. 首次介紹這項功能時，請提示使用者新增 資訊方塊。