destroy()
destroy() 方法由商户应用调用,用于销毁 AMSPaymentElement 实例并释放所有关联资源,包括已注册的事件监听器。
注意:
- 调用此方法后,该实例不应再被使用。
- 需在收银台页面关闭或不再需要支付组件时调用。
方法签名
copy
Future<void> destroy()参数
此方法无入参。
返回值
返回一个 Future<void>,用于表示资源释放操作的异步执行状态;当所有资源释放完成时,该 Future 结束,且不返回具体结果。
调用场景
手动调用
在以下情况下,调用此方法来释放 SDK 组件资源:
- 当买家切换视图离开结账页面时,释放在 createPaymentSession(单笔支付) 接口中创建的组件资源。
- 当买家发起多笔支付,并且 configurations 中的参数发生改变时,释放之前 createPaymentSession(单笔支付) 接口中创建的组件资源。
SDK 自动释放
在以下情况 SDK 会自动释放资源:
- 当买家发起多笔支付,并且 configurations 中的参数未发生变更。SDK 会在支付结束后自行回收部分资源,以重置到
createComponent()之前的状态。