PrinterDiscoverySession 類別

定義

[Android.Runtime.Register("android/printservice/PrinterDiscoverySession", DoNotGenerateAcw=true)]
public abstract class PrinterDiscoverySession : Java.Lang.Object

[<Android.Runtime.Register("android/printservice/PrinterDiscoverySession", DoNotGenerateAcw=true)>]
type PrinterDiscoverySession = class
    inherit Object

繼承

Object

JavaObject

Object

PrinterDiscoverySession

屬性

RegisterAttribute

備註

此類別封裝了印表機發現過程中，列印服務與系統之間的互動。 在列印發現過程中，你負責新增已發現的印表機、移除先前已刪除的印表機，以及更新已新增的印表機。

在此工作階段的運作期間，你可能會被要求多次開始或停止印表機發現。 您將接到一通電話， PrinterDiscoverySession#onStartPrinterDiscovery(List) 要求開始印表機發現，以及一通停止印表機發現的電話 PrinterDiscoverySession#onStopPrinterDiscovery() 。 當系統不再對此會話發現的印表機感興趣時，你會收到一通呼叫 #onDestroy() ，屆時系統將不再呼叫該會話，所有會話方法也將不再運作。

發現的印表機是透過呼叫 PrinterDiscoverySession#addPrinters(List)來新增的。 新增且消失的印表機會透過呼叫 PrinterDiscoverySession#removePrinters(List)移除。 新增的印表機若其屬性或功能有所變更，則會透過呼叫 進行 PrinterDiscoverySession#addPrinters(List)更新。 此階段新增的印表機可透過 #getPrinters() 此方式取得，回傳印表機將為你在會話中回報的印表機的 up-to日期快照。 印表機在多個工作階段中持續<存在，但很強><>。

系統會呼叫你需要 #onValidatePrinters(List) 更新印表機。 你有可能在沒有指定功能的情況下新增印表機。 這讓你避免查詢所有已發現的印表機的功能，而是僅在必要時查詢印表機的功能。 例如，系統會要求你更新使用者選擇的印表機。 驗證印表機時，您不必提供印表機的功能，但可以提供。

如果系統需要持續更新印表機狀態，你就會接到電話 #onStartPrinterStateTracking(PrinterId) ，之後你必須盡力讓系統隨時掌握印表機狀態和功能的變化。 < > < >如果你在新增印表機時沒有提供，也必須強烈更新印表機功能，否則印表機會被忽略。 當系統不再關注列印機的更新時，您將收到一通電話。#onStopPrinterStateTracking( PrinterId)

<strong>注意： </strong> 此類別中的所有回調皆在主應用程式執行緒執行。 你也必須在主應用程式執行緒中呼叫這個類別的任何方法。

Java 文件 android.printservice.PrinterDiscoverySession。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。