Android 11下SUNMI P2终端支付完成后无法从Besteron界面切回自研应用的解决方案咨询

问题场景 #

我在搭载Android 11的SUNMI P2终端上遇到了支付后界面切换的棘手问题：终端集成了NEXO协议和Besteron支付模块，自研APP通过HTTP请求调用NEXO API唤起Besteron的支付UI引导用户刷卡，但用户完成刷卡后，Besteron的UI一直停留在前台，无法自动切回我的APP。

当前尝试的解决方案及问题 #

我在CheckoutFragment.kt中监听paymentResult的回调，收到支付响应后尝试用Intent.FLAG_ACTIVITY_REORDER_TO_FRONT启动MainActivity，但没有效果；随后调用viewModel.doTransactionTickets触发transactionResult.collect，尝试导航到确认页，同样无法切换回自研APP的界面。相关代码如下：

viewLifecycleOwner.lifecycleScope.launch {
  viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.CREATED) {
     viewModel.paymentResult.collect {
       Log.d("paymentTest", "The payment response has been received: $it")

       val intent = Intent(requireActivity(), MainActivity::class.java).apply {
         flags = Intent.FLAG_ACTIVITY_REORDER_TO_FRONT
       }

       requireActivity().startActivity(intent)
       viewModel.doTransactionTickets (
         binding.noteText.editText?.text.toString(),
         args.itemType,
         args.itemId,
         args.selectedTickets!!.tickets,
         totalPrice.formatWithDecimalPlaces(),
         args.date,
         args.packItems?.result,
         args.itemSeats,
         client
       )
     }
  }
}

viewLifecycleOwner.lifecycleScope.launch {
  viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.CREATED) {
    viewModel.transactionResult.collect { item ->
      val receipt = viewModel.receiptPdf.value?.let { PdfDocument(it) }
      val ticket = viewModel.ticketPdf.value?.let { PdfDocument(it) }
      Log.d("paymentTest", "Transaction done")
      requireActivity().runOnUiThread {
        findNavController().navigate(
          R.id.action_checkoutFragment_to_confirmationFragment,
          Bundle().apply {
            putString("name", args.name)
            putFloat("totalPrice", totalPrice.toFloat())
            putString(
              "ticketsDescription",
              binding.summaryTicketBreakdown.text.toString()
            )
            putString("eventDateTime", args.date)
            putString("orderNumber", item.toString())
            putInt("itemType", args.itemType)
            putBoolean("hasTimetable", args.hasTimetable)
            putSerializable("receipt", receipt)
            putSerializable("ticket", ticket)
          }
        )
      }
    }
  }
}

可行的排查与解决方向 #

商用终端的前台切换问题往往要结合终端定制特性和Android版本权限限制来解决，给你几个具体的思路：

• 检查SUNMI终端的专属配置与权限
  SUNMI这类商用终端通常有系统级的前台启动限制，你可以：

  1. 查看SUNMI开发者文档，确认支付模块回调是否需要将APP加入终端的「前台白名单」；
  2. 在Manifest中申请android.permission.REORDER_TASKS权限，部分终端需要手动在系统设置中给APP授权该权限；
  3. 尝试申请SYSTEM_ALERT_WINDOW权限（Android 11中该权限需要用户手动授予），确保APP有弹出或切换前台的权限。

• 调整Intent Flags组合
  单一的FLAG_ACTIVITY_REORDER_TO_FRONT可能不足以在第三方应用占据前台时拉起APP，建议尝试组合Flag：

  val intent = Intent(requireActivity(), MainActivity::class.java).apply {
    flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_REORDER_TO_FRONT
  }
  

  这样既可以确保任务栈的清理，又能将现有Activity移到前台。

• 改用广播接收器监听支付完成事件
  可能NEXO协议或Besteron支付模块在支付完成后会发送系统广播，你可以注册一个广播接收器，在收到广播时再执行前台切换逻辑，这样优先级比HTTP响应回调更高：

  1. 在Fragment中动态注册广播，监听支付完成的Action；
  2. 在广播回调中执行拉起MainActivity或导航的逻辑。

• 调整Lifecycle监听状态
  当前代码使用Lifecycle.State.CREATED来监听paymentResult，如果支付过程中Fragment的生命周期已经进入STARTED或RESUMED，回调可能无法及时触发。建议改成Lifecycle.State.STARTED：

  viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
    // 原collect逻辑
  }
  

• 尝试用ActivityManager强制切换任务栈
  在Android 11中，可以通过ActivityManager的appTasks将自己的任务栈移到前台：

  val am = requireContext().getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
  am.appTasks.forEach { task ->
      if (task.taskInfo.baseActivity?.packageName == requireContext().packageName) {
          task.moveToFront()
      }
  }
  

  注意需要在Manifest中申请android.permission.REORDER_TASKS权限，并且部分终端可能需要额外的系统授权。

• 确认Besteron支付UI的退出逻辑
  查看Besteron的集成文档，确认是否有支付完成后主动关闭其UI的API调用。如果Besteron的UI没有正确finish()，即使拉起自己的APP，也可能被它的界面遮挡。

备注：内容来源于stack exchange，提问作者CitroenAX