chrome.documentScan

Descrizione

Utilizza l'API chrome.documentScan per rilevare e recuperare immagini da scanner per documenti collegati.

L'API Document Scan è progettata per consentire ad app ed estensioni di visualizzare il contenuto di documenti cartacei su uno scanner per documenti collegato.

Autorizzazioni

documentScan

Disponibilità

Chrome 44+ Solo ChromeOS
La disponibilità per i membri dell'API aggiunti in un secondo momento viene mostrata insieme a questi membri.

Concetti e utilizzo

Questa API supporta due metodi di scansione dei documenti. Se il tuo caso d'uso può funzionare con qualsiasi scanner e non richiede il controllo della configurazione, utilizza il metodo scan(). I casi d'uso più complessi richiedono una combinazione di metodi, supportati solo in Chrome 124 e versioni successive.

Scansione semplice

Per i casi d'uso semplici, ovvero quelli che possono funzionare con qualsiasi scanner e non richiedono il controllo della configurazione, chiama scan(). Questo metodo accetta un oggetto ScanOptions e restituisce una promessa che viene risolta con un oggetto ScanResults. Le funzionalità di questa opzione sono limitate al numero di scansioni e ai tipi MIME che verranno accettati dal chiamante. Le scansioni vengono restituite come URL da visualizzare in un tag <img> per un'interfaccia utente.

Scansione complessa

Le scansioni complesse vengono eseguite in tre fasi, come descritto in questa sezione. Questo schema non descrive ogni argomento del metodo o ogni proprietà restituita in una risposta. Ha il solo scopo di fornirti una guida generale alla scrittura del codice dello scanner.

Discovery

  1. Chiama il numero getScannerList(). Gli scanner disponibili vengono restituiti in una promessa che si risolve con un GetScannerListResponse.

    • L'oggetto di risposta contiene un array di oggetti ScannerInfo.
    • L'array può contenere più voci per un singolo scanner se questo supporta più protocolli o metodi di connessione.

  2. Seleziona uno scanner dall'array restituito e salva il valore della proprietà scannerId.

    Utilizza le proprietà dei singoli oggetti ScannerInfo per distinguere più oggetti per lo stesso scanner. Gli oggetti dello stesso scanner avranno lo stesso valore per la proprietà deviceUuid. ScannerInfo contiene anche una proprietà imageFormats contenente un array di tipi di immagini supportati.

Configurazione dello scanner

  1. Chiama openScanner(), passando l'ID scanner salvato. Restituisce una promessa che si risolve con un OpenScannerResponse. L'oggetto di risposta contiene:

    • Una proprietà scannerHandle, che dovrai salvare.

    • Una proprietà delle opzioni contenente proprietà specifiche dello scanner, che dovrai impostare. Per saperne di più, consulta Recuperare le opzioni dello scanner.

  2. (Facoltativo) Se hai bisogno che l'utente fornisca valori per le opzioni dello scanner, crea un'interfaccia utente. Avrai bisogno delle opzioni dello scanner fornite nel passaggio precedente e dovrai recuperare i gruppi di opzioni forniti dallo scanner. Per ulteriori informazioni, consulta la sezione Costruire un'interfaccia utente.

  3. Costruisci un array di oggetti OptionSetting utilizzando valori forniti dall'utente o programmatici. Per ulteriori informazioni, consulta Impostare le opzioni dello scanner.

  4. Passa l'array di oggetti OptionSetting a setOptions() per impostare le opzioni per lo scanner. Restituisce una promessa che si risolve con un SetOptionsResponse. Questo oggetto contiene una versione aggiornata delle opzioni dello scanner recuperate nel passaggio 1 della configurazione dello scanner.

    Poiché la modifica di un'opzione può alterare i vincoli di un'altra, potresti dover ripetere questi passaggi più volte.

Analisi in corso

  1. Crea un oggetto StartScanOptions e passalo a startScan(). Restituisce una promessa che si risolve con un StartScanResponse. La proprietà job è un handle che utilizzerai per leggere i dati di scansione o annullare la scansione.

  2. Passa l'handle del job a readScanData(). Restituisce una promessa che viene risolta con un oggetto ReadScanDataResponse. Se i dati sono stati letti correttamente, la proprietà result è uguale a SUCCESS e la proprietà data contiene un ArrayBuffer con parte della scansione. Tieni presente che estimatedCompletion contiene una percentuale stimata dei dati totali che sono stati pubblicati finora.

  3. Ripeti il passaggio precedente finché la proprietà result non è uguale a EOF o non si verifica un errore.

Quando viene raggiunta la fine della scansione, chiama closeScanner() con l'handle dello scanner salvato nel passaggio 3. Restituisce una promessa che si risolve con un CloseScannerResponse. Chiamare cancelScan() in qualsiasi momento dopo la creazione del job interromperà la scansione.

Oggetti di risposta

Tutti i metodi restituiscono una promessa che viene risolta con un oggetto di risposta di qualche tipo. La maggior parte di questi contiene una proprietà result il cui valore è un membro di OperationResult. Alcune proprietà degli oggetti di risposta non contengono valori, a meno che il valore di result non sia specifico. Queste relazioni sono descritte nel riferimento per ogni oggetto risposta.

Ad esempio, OpenScannerResponse.scannerHandle avrà un valore solo quando OpenScannerResponse.result è uguale a SUCCESS.

Opzioni dello scanner

Le opzioni dello scanner variano notevolmente in base al dispositivo. Di conseguenza, non è possibile riflettere le opzioni dello scanner direttamente nell'API documentScan. Per ovviare a questo problema, OpenScannerResponse (recuperato utilizzando openScanner()) e SetOptionsResponse (l'oggetto risposta per setOptions()) contengono una proprietà options, ovvero un oggetto contenente opzioni specifiche dello scanner. Ogni opzione è un mapping chiave-valore in cui la chiave è un'opzione specifica del dispositivo e il valore è un'istanza di ScannerOption.

La struttura in genere ha questo aspetto:

{   "key1": { scannerOptionInstance }   "key2": { scannerOptionInstance } }

Ad esempio, immagina uno scanner che restituisce opzioni denominate "source" e "resolution". La struttura dell'oggetto options restituito sarà simile al seguente esempio. Per semplicità, vengono mostrate solo le risposte parziali ScannerOption.

{   "source": {     "name": "source",     "type": OptionType.STRING, ... },   "resolution": {     "name": "resolution",     "type": OptionType.INT, ...   }, ... }

Costruire un'interfaccia utente

Sebbene non sia obbligatorio utilizzare questa API, potresti voler consentire a un utente di scegliere il valore per una determinata opzione. Ciò richiede un'interfaccia utente. Utilizza OpenScannerResponse (aperto da openScanner()) per recuperare le opzioni per lo scanner collegato, come descritto nella sezione precedente.

Alcuni scanner raggruppano le opzioni in modi specifici per il dispositivo. Non influiscono sul comportamento delle opzioni, ma poiché questi gruppi potrebbero essere menzionati nella documentazione del prodotto di uno scanner, devono essere mostrati all'utente. Puoi recuperare questi gruppi chiamando il numero getOptionGroups(). Restituisce una promessa che viene risolta con un oggetto GetOptionGroupsResponse. La proprietà groups contiene un array di gruppi specifico per lo scanner. Utilizza le informazioni di questi gruppi per organizzare le opzioni nel OpenScannerResponse per la visualizzazione.

{   scannerHandle: "123456",   result: SUCCESS,   groups: [     {       title: "Standard",       members: [ "resolution", "mode", "source" ]     }   ] }

Come indicato in Configurazione dello scanner, la modifica di un'opzione può alterare i vincoli di un'altra opzione. Per questo motivo, setOptionsResponse (l'oggetto di risposta per setOptions()) contiene un'altra proprietà options. Utilizza questo comando per aggiornare l'interfaccia utente. Poi ripeti l'operazione in base alle necessità finché non hai impostato tutte le opzioni.

Impostare le opzioni dello scanner

Imposta le opzioni dello scanner passando un array di oggetti OptionSetting a setOptions(). Per un esempio, consulta la sezione Scansionare una pagina in formato lettera.

Esempi

Recuperare una pagina come blob

Questo esempio mostra un modo per recuperare una pagina dallo scanner come blob e dimostra l'utilizzo di startScan() e readScanData() utilizzando il valore di OperationResult.

async function pageAsBlob(handle) {   let response = await chrome.documentScan.startScan(       handle, {format: "image/jpeg"});   if (response.result != chrome.documentScan.OperationResult.SUCCESS) {     return null;   }   const job = response.job;    let imgParts = [];   response = await chrome.documentScan.readScanData(job);   while (response.result == chrome.documentScan.OperationResult.SUCCESS) {     if (response.data && response.data.byteLength > 0) {         imgParts.push(response.data);     } else {       // Delay so hardware can make progress.       await new Promise(r => setTimeout(r, 100));     }     response = await chrome.documentScan.readScanData(job);   }   if (response.result != chrome.documentScan.OperationResult.EOF) {     return null;   }   if (response.data && response.data.byteLength > 0) {     imgParts.push(response.data);   }   return new Blob(imgParts, { type: "image/jpeg" }); }

Scansionare una pagina in formato Letter

Questo esempio mostra come selezionare uno scanner, impostarne le opzioni e aprirlo. Recupera quindi i contenuti di una singola pagina e chiude lo scanner. Questa procedura mostra l'utilizzo di getScannerList(), openScanner(), setOptions() e closeScanner(). Tieni presente che i contenuti della pagina vengono recuperati chiamando la funzione pageAsBlob() dell'esempio precedente.

async function scan() {     let response = await chrome.documentScan.getScannerList({ secure: true });     let scanner = await chrome.documentScan.openScanner(         response.scanners[0].scannerId);     const handle = scanner.scannerHandle;      let options = [];     for (source of scanner.options["source"].constraint.list) {         if (source.includes("ADF")) {             options.push({                 name: "source",                 type: chrome.documentScan.OptionType.STRING,                 value: { value: source }             });             break;         }     }     options.push({         name: "tl-x",         type: chrome.documentScan.OptionType.FIXED,         value: 0.0     });     options.push({         name: "br-x",         type: chrome.documentScan.OptionType.FIXED,         value: 215.9  // 8.5" in mm     });     options.push({         name: "tl-y",         type: chrome.documentScan.OptionType.FIXED,         value: 0.0     });     options.push({         name: "br-y",         type: chrome.documentScan.OptionType.FIXED,         value: 279.4  // 11" in mm     });     response = await chrome.documentScan.setOptions(handle, options);      let imgBlob = await pageAsBlob(handle);     if (imgBlob != null) {         // Insert imgBlob into DOM, save to disk, etc     }     await chrome.documentScan.closeScanner(handle); }

Mostra la configurazione

Come indicato altrove, per mostrare a un utente le opzioni di configurazione di uno scanner è necessario chiamare getOptionGroups() oltre alle opzioni dello scanner restituite da una chiamata a openScanner(). In questo modo, le opzioni possono essere mostrate agli utenti nei gruppi definiti dal produttore. Questo esempio mostra come farlo.

async function showConfig() {   let response = await chrome.documentScan.getScannerList({ secure: true });   let scanner = await chrome.documentScan.openScanner(       response.scanners[0].scannerId);   let groups = await chrome.documentScan.getOptionGroups(scanner.scannerHandle);    for (const group of groups.groups) {     console.log("=== " + group.title + " ===");     for (const member of group.members) {       const option = scanner.options[member];       if (option.isActive) {         console.log("  " + option.name + " = " + option.value);       } else {         console.log("  " + option.name + " is inactive");       }     }   } }

Tipi

CancelScanResponse

Chrome 125+

Proprietà

  • job

    stringa

    Fornisce lo stesso handle del job passato a cancelScan().

  • risultato

    OperationResult

    Il risultato dell'annullamento della scansione del backend. Se il risultato è OperationResult.SUCCESS o OperationResult.CANCELLED, la scansione è stata annullata e lo scanner è pronto per iniziare una nuova scansione. Se il risultato è OperationResult.DEVICE_BUSY , lo scanner sta ancora elaborando l'annullamento richiesto; il chiamante deve attendere un breve periodo di tempo e riprovare a effettuare la richiesta. Altri valori dei risultati indicano un errore permanente che non deve essere riprovato.

CloseScannerResponse

Chrome 125+

Proprietà

  • risultato

    OperationResult

    Il risultato della chiusura dello scanner. Anche se questo valore non è SUCCESS, l'handle non è valido e non deve essere utilizzato per ulteriori operazioni.

  • scannerHandle

    stringa

    Lo stesso handle dello scanner passato a closeScanner.

Configurability

Chrome 125+

Come può essere modificata un'opzione.

Enum

"NOT_CONFIGURABLE"
L'opzione è di sola lettura.

"SOFTWARE_CONFIGURABLE"
L'opzione può essere impostata nel software.

"HARDWARE_CONFIGURABLE"
L'opzione può essere impostata dall'utente attivando o premendo un pulsante sullo scanner.

ConnectionType

Chrome 125+

Indica in che modo lo scanner è collegato al computer.

Enum

"UNSPECIFIED"

"USB"

"NETWORK"

ConstraintType

Chrome 125+

Il tipo di dati del vincolo rappresentato da un OptionConstraint.

Enum

"INT_RANGE"
Il vincolo su un intervallo di valori OptionType.INT. Le proprietà min, max e quant di OptionConstraint saranno long e la proprietà list verrà annullata.

"INTERVALLO_FISSO"
Il vincolo su un intervallo di valori OptionType.FIXED. Le proprietà min, max e quant di OptionConstraint saranno double e la proprietà list non sarà impostata.

"INT_LIST"
Il vincolo su un elenco specifico di valori OptionType.INT. La proprietà OptionConstraint.list conterrà i valori long e le altre proprietà non verranno impostate.

"FIXED_LIST"
Il vincolo su un elenco specifico di valori OptionType.FIXED. La proprietà OptionConstraint.list conterrà i valori double e le altre proprietà non verranno impostate.

"STRING_LIST"
Il vincolo su un elenco specifico di valori OptionType.STRING. La proprietà OptionConstraint.list conterrà i valori DOMString e le altre proprietà non verranno impostate.

DeviceFilter

Chrome 125+

Proprietà

  • local

    booleano facoltativo

    Restituisci solo gli scanner collegati direttamente al computer.

  • sicuro

    booleano facoltativo

    Restituisci solo gli scanner che utilizzano un trasporto sicuro, ad esempio USB o TLS.

GetOptionGroupsResponse

Chrome 125+

Proprietà

  • gruppi

    OptionGroup[] facoltativo

    Se result è SUCCESS, fornisce un elenco di gruppi di opzioni nell'ordine fornito dal driver dello scanner.

  • risultato

    OperationResult

    Il risultato dell'ottenimento dei gruppi di opzioni. Se il valore è SUCCESS, la proprietà groups verrà compilata.

  • scannerHandle

    stringa

    Lo stesso handle dello scanner passato a getOptionGroups.

GetScannerListResponse

Chrome 125+

Proprietà

  • risultato

    OperationResult

    Il risultato dell'enumerazione. Tieni presente che potrebbero essere restituiti risultati parziali anche se viene indicato un errore.

  • scanner

    ScannerInfo[]

    Un elenco, possibilmente vuoto, di scanner che corrispondono al DeviceFilter fornito.

OpenScannerResponse

Chrome 125+

Proprietà

  • opzioni

    oggetto facoltativo

    Se result è SUCCESS, fornisce una mappatura chiave-valore in cui la chiave è un'opzione specifica del dispositivo e il valore è un'istanza di ScannerOption.

  • risultato

    OperationResult

    Il risultato dell'apertura dello scanner. Se il valore è SUCCESS, le proprietà scannerHandle e options verranno compilate.

  • scannerHandle

    stringa facoltativa

    Se result è SUCCESS, un handle dello scanner che può essere utilizzato per ulteriori operazioni.

  • scannerId

    stringa

    L'ID scanner passato a openScanner().

OperationResult

Chrome 125+

Un'enumerazione che indica il risultato di ogni operazione.

Enum

"UNKNOWN"
Si è verificato un errore sconosciuto o generico.

"SUCCESS"
L'operazione è riuscita.

"UNSUPPORTED"
L'operazione non è supportata.

"ANNULLATO"
L'operazione è stata annullata.

"DEVICE_BUSY"
Il dispositivo è occupato.

"INVALID"
I dati o un argomento passato al metodo non sono validi.

"WRONG_TYPE"
Il valore fornito è il tipo di dati errato per l'opzione sottostante.

"EOF"
Non sono disponibili altri dati.

"ADF_JAMMED"
L'alimentatore di documenti è inceppato.

"ADF_EMPTY"
L'alimentatore di documenti è vuoto.

"COVER_OPEN"
Il coperchio dello scanner piano è aperto.

"IO_ERROR"
Si è verificato un errore durante la comunicazione con il dispositivo.

"ACCESS_DENIED"
Il dispositivo richiede l'autenticazione.

"NO_MEMORY"
Su Chromebook non è disponibile memoria sufficiente per completare l'operazione.

"UNREACHABLE"
Il dispositivo non è raggiungibile.

"MISSING"
Il dispositivo è disconnesso.

"INTERNAL_ERROR"
Si è verificato un errore in un'applicazione diversa da quella chiamante.

OptionConstraint

Chrome 125+

Proprietà

  • list

    string[] | number[] facoltativo

  • max

    number (facoltativo)

  • min

    number (facoltativo)

  • quant

    number (facoltativo)

OptionGroup

Chrome 125+

Proprietà

  • membri

    string[]

    Un array di nomi di opzioni nell'ordine fornito dal conducente.

  • titolo

    stringa

    Fornisce un titolo stampabile, ad esempio "Opzioni di geometria".

OptionSetting

Chrome 125+

Proprietà

  • nome

    stringa

    Indica il nome dell'opzione da impostare.

  • tipo

    OptionType

    Indica il tipo di dati dell'opzione. Il tipo di dati richiesto deve corrispondere al tipo di dati effettivo dell'opzione sottostante.

  • valore

    stringa | numero | booleano | number[] facoltativo

    Indica il valore da impostare. Lascia non impostato per richiedere l'impostazione automatica per le opzioni per cui è attivata l'opzione autoSettable. Il tipo di dati fornito per value deve corrispondere a type.

OptionType

Chrome 125+

Il tipo di dati di un'opzione.

Enum

"UNKNOWN"
Il tipo di dati dell'opzione è sconosciuto. La proprietà value verrà annullata.

"BOOL"
La proprietà value sarà una delle seguenti: truefalse.

"INT"
Un numero intero a 32 bit con segno. La proprietà value sarà long o long[], a seconda che l'opzione accetti più di un valore.

"FIXED"
Un numero double nell'intervallo -32768-32767,9999 con una risoluzione di 1/65535. La proprietà value sarà double o double[], a seconda che l'opzione accetti più di un valore. I valori doppi che non possono essere rappresentati esattamente verranno arrotondati all'intervallo e alla precisione disponibili.

"STRING"
Una sequenza di byte qualsiasi, tranne NUL ("\0"). La proprietà value sarà una DOMString.

"BUTTON"
Un'opzione di questo tipo non ha alcun valore. L'impostazione di un'opzione di questo tipo, invece, causa un effetto collaterale specifico dell'opzione nel driver dello scanner. Ad esempio, un'opzione di tipo pulsante potrebbe essere utilizzata da un driver dello scanner per fornire un mezzo per selezionare i valori predefiniti o per indicare a un alimentatore automatico di documenti di passare al foglio di carta successivo.

"GROUP"
Opzione di raggruppamento. Nessun valore. Questo valore è incluso per compatibilità, ma normalmente non viene restituito nei valori ScannerOption. Utilizza getOptionGroups() per recuperare l'elenco dei gruppi con le relative opzioni per i membri.

OptionUnit

Chrome 125+

Indica il tipo di dati per ScannerOption.unit.

Enum

"UNITLESS"
Il valore è un numero senza unità. Ad esempio, può essere una soglia.

"PIXEL"
Il valore è un numero di pixel, ad esempio le dimensioni della scansione.

"BIT"
Il valore è il numero di bit, ad esempio la profondità del colore.

"MM"
Il valore è misurato in millimetri, ad esempio le dimensioni della scansione.

"DPI"
Il valore viene misurato in punti per pollice, ad esempio la risoluzione.

"PERCENT"
Il valore è una percentuale, ad esempio la luminosità.

"MICROSECOND"
Il valore è misurato in microsecondi, ad esempio il tempo di esposizione.

ReadScanDataResponse

Chrome 125+

Proprietà

  • dati

    ArrayBuffer facoltativo

    Se result è SUCCESS, contiene il blocco successivo di dati dell'immagine scansionata. Se result è EOF, contiene l'ultimo blocco di dati dell'immagine scansionata.

  • estimatedCompletion

    number (facoltativo)

    Se result è SUCCESS, una stima della quantità di dati di scansione totali che sono stati inviati finora, compresa tra 0 e 100.

  • job

    stringa

    Fornisce l'handle del job passato a readScanData().

  • risultato

    OperationResult

    Il risultato della lettura dei dati. Se il valore è SUCCESS, data contiene il blocco di dati dell'immagine successivo (possibilmente di lunghezza zero) pronto per la lettura. Se il valore è EOF, data contiene l'ultimo blocco di dati dell'immagine.

ScannerInfo

Chrome 125+

Proprietà

  • connectionType

    ConnectionType

    Indica in che modo lo scanner è collegato al computer.

  • deviceUuid

    stringa

    Per la corrispondenza con altre voci ScannerInfo che puntano allo stesso dispositivo fisico.

  • imageFormats

    string[]

    Un array di tipi MIME che possono essere richiesti per le scansioni restituite.

  • produttore

    stringa

    Il produttore dello scanner.

  • modello

    stringa

    Il modello dello scanner, se disponibile, o una descrizione generica.

  • nome

    stringa

    Un nome leggibile per lo scanner da visualizzare nell'interfaccia utente.

  • protocolType

    stringa

    Una descrizione leggibile del protocollo o del driver utilizzato per accedere allo scanner, ad esempio Mopria, WSD o epsonds. Questa opzione è utile principalmente per consentire a un utente di scegliere tra i protocolli se un dispositivo ne supporta più di uno.

  • scannerId

    stringa

    L'ID di uno scanner specifico.

  • sicuro

    booleano

    Se è true, il trasporto della connessione dello scanner non può essere intercettato da un listener passivo, ad esempio TLS o USB.

ScannerOption

Chrome 125+

Proprietà

  • configurabilità

    Configurabilità

    Indica se e come l'opzione può essere modificata.

  • vincolo

    OptionConstraint facoltativo

    Definisce OptionConstraint nell'opzione dello scanner attuale.

  • descrizione

    stringa

    Una descrizione più lunga dell'opzione.

  • isActive

    booleano

    Indica che l'opzione è attiva e può essere impostata o recuperata. Se il valore è false, la proprietà value non verrà impostata.

  • isAdvanced

    booleano

    Indica che l'interfaccia utente non deve visualizzare questa opzione per impostazione predefinita.

  • isAutoSettable

    booleano

    Può essere impostato automaticamente dal driver dello scanner.

  • isDetectable

    booleano

    Indica che questa opzione può essere rilevata dal software.

  • isEmulated

    booleano

    Emulato dal driver dello scanner se true.

  • nome

    stringa

    Il nome dell'opzione utilizzando lettere ASCII minuscole, numeri e trattini. I segni diacritici non sono consentiti.

  • titolo

    stringa

    Un titolo stampabile di una riga.

  • tipo

    OptionType

    Il tipo di dati contenuti nella proprietà value, necessario per impostare questa opzione.

  • unità

    OptionUnit

    L'unità di misura per questa opzione.

  • valore

    stringa | numero | booleano | number[] facoltativo

    Il valore attuale dell'opzione, se pertinente. Tieni presente che il tipo di dati di questa proprietà deve corrispondere al tipo di dati specificato in type.

ScanOptions

Proprietà

  • maxImages

    number (facoltativo)

    Il numero di immagini scansionate consentite. Il valore predefinito è 1.

  • mimeTypes

    string[] facoltativo

    I tipi MIME accettati dal chiamante.

ScanResults

Proprietà

  • dataUrls

    string[]

    Un array di URL di immagini di dati in un formato che può essere passato come valore "src" a un tag immagine.

  • mimeType

    stringa

    Il tipo MIME di dataUrls.

SetOptionResult

Chrome 125+

Proprietà

  • nome

    stringa

    Indica il nome dell'opzione impostata.

  • risultato

    OperationResult

    Indica il risultato dell'impostazione dell'opzione.

SetOptionsResponse

Chrome 125+

Proprietà

  • opzioni

    oggetto facoltativo

    Una mappatura chiave-valore aggiornata dai nomi delle opzioni ai valori ScannerOption contenenti la nuova configurazione dopo aver tentato di impostare tutte le opzioni fornite. Ha la stessa struttura della proprietà options in OpenScannerResponse.

    Questa proprietà verrà impostata anche se alcune opzioni non sono state impostate correttamente, ma verrà annullata se il recupero della configurazione aggiornata non riesce (ad esempio, se lo scanner viene disconnesso durante la scansione).

  • risultati

    SetOptionResult[]

    Un array di risultati, uno per ogni OptionSetting passato.

  • scannerHandle

    stringa

    Fornisce l'handle dello scanner passato a setOptions().

StartScanOptions

Chrome 125+

Proprietà

  • dell'annuncio

    stringa

    Specifica il tipo MIME in cui restituire i dati scansionati.

  • maxReadSize

    number (facoltativo)

    Se viene specificato un valore diverso da zero, limita a questo valore il numero massimo di byte scansionati restituiti in una singola risposta readScanData. Il valore minimo consentito è 32768 (32 KB). Se questa proprietà non viene specificata, le dimensioni di un blocco restituito possono corrispondere all'intera immagine scansionata.

StartScanResponse

Chrome 125+

Proprietà

  • job

    stringa facoltativa

    Se result è SUCCESS, fornisce un handle che può essere utilizzato per leggere i dati di scansione o annullare il job.

  • risultato

    OperationResult

    Il risultato dell'avvio di una scansione. Se il valore è SUCCESS, la proprietà job verrà compilata.

  • scannerHandle

    stringa

    Fornisce lo stesso handle dello scanner passato a startScan().

Metodi

cancelScan()

Chrome 125+ 
chrome.documentScan.cancelScan(
  job: string,
): Promise<CancelScanResponse>

Annulla una scansione avviata e restituisce una promessa che viene risolta con un oggetto CancelScanResponse. Se viene utilizzata una funzione di callback, l'oggetto viene passato a quest'ultima.

Parametri

  • job

    stringa

    L'handle di un job di scansione attivo restituito in precedenza da una chiamata a startScan.

Resi

closeScanner()

Chrome 125+ 
chrome.documentScan.closeScanner(
  scannerHandle: string,
): Promise<CloseScannerResponse>

Chiude lo scanner con l'handle passato e restituisce una promessa che viene risolta con un oggetto CloseScannerResponse. Se viene utilizzata una funzione di callback, l'oggetto viene passato a quest'ultima. Anche se la risposta non ha esito positivo, l'handle fornito diventa non valido e non deve essere utilizzato per ulteriori operazioni.

Parametri

  • scannerHandle

    stringa

    Specifica l'handle di uno scanner aperto restituito in precedenza da una chiamata a openScanner.

Resi

getOptionGroups()

Chrome 125+ 
chrome.documentScan.getOptionGroups(
  scannerHandle: string,
): Promise<GetOptionGroupsResponse>

Recupera i nomi dei gruppi e le opzioni dei membri da uno scanner aperto in precedenza da openScanner. Questo metodo restituisce una promessa che viene risolta con un oggetto GetOptionGroupsResponse. Se a questa funzione viene trasmessa una callback, i dati restituiti vengono trasmessi a quest'ultima.

Parametri

  • scannerHandle

    stringa

    L'handle di uno scanner aperto restituito da una chiamata a openScanner.

Resi

getScannerList()

Chrome 125+ 
chrome.documentScan.getScannerList(
  filter: DeviceFilter,
): Promise<GetScannerListResponse>

Recupera l'elenco degli scanner disponibili e restituisce una promessa che viene risolta con un oggetto GetScannerListResponse. Se a questa funzione viene trasmessa una callback, i dati restituiti vengono trasmessi a quest'ultima.

Parametri

Resi

openScanner()

Chrome 125+ 
chrome.documentScan.openScanner(
  scannerId: string,
): Promise<OpenScannerResponse>

Apre uno scanner per l'accesso esclusivo e restituisce una promessa che viene risolta con un oggetto OpenScannerResponse. Se a questa funzione viene trasmessa una callback, i dati restituiti vengono trasmessi a quest'ultima.

Parametri

  • scannerId

    stringa

    L'ID di uno scanner da aprire. Questo valore è uno di quelli restituiti da una chiamata precedente a getScannerList.

Resi

readScanData()

Chrome 125+ 
chrome.documentScan.readScanData(
  job: string,
): Promise<ReadScanDataResponse>

Legge il successivo blocco di dati immagine disponibili da un handle di job attivo e restituisce una promessa che viene risolta con un oggetto ReadScanDataResponse. Se viene utilizzata una funzione di callback, l'oggetto viene passato a quest'ultima.

**Nota:**è valido che un risultato di risposta sia SUCCESS con un membro data di lunghezza zero. Ciò significa che lo scanner funziona ancora, ma non ha ancora dati aggiuntivi pronti. Il chiamante deve attendere un breve periodo di tempo e riprovare.

Al termine del job di scansione, la risposta avrà il valore del risultato EOF. Questa risposta potrebbe contenere un membro data finale diverso da zero.

Parametri

  • job

    stringa

    Handle del job attivo restituito in precedenza da startScan.

Resi

scan()

chrome.documentScan.scan(
  options: ScanOptions,
): Promise<ScanResults>

Esegue la scansione di un documento e restituisce una promessa che viene risolta con un oggetto ScanResults. Se a questa funzione viene passata una funzione di callback, i dati restituiti vengono passati a quest'ultima.

Parametri

  • opzioni

    ScanOptions

    Un oggetto contenente i parametri di scansione.

Resi

setOptions()

Chrome 125+ 
chrome.documentScan.setOptions(
  scannerHandle: string,
  options: OptionSetting[],
): Promise<SetOptionsResponse>

Imposta le opzioni sullo scanner specificato e restituisce una promessa che viene risolta con un oggetto SetOptionsResponse contenente il risultato del tentativo di impostare ogni valore nell'ordine dell'oggetto OptionSetting passato. Se viene utilizzata una funzione di callback, l'oggetto viene passato a quest'ultima.

Parametri

  • scannerHandle

    stringa

    La maniglia dello scanner su cui impostare le opzioni. Questo deve essere un valore restituito in precedenza da una chiamata a openScanner.

  • opzioni

    OptionSetting[]

    Un elenco di OptionSetting oggetti da applicare allo scanner.

Resi

startScan()

Chrome 125+ 
chrome.documentScan.startScan(
  scannerHandle: string,
  options: StartScanOptions,
): Promise<StartScanResponse>

Avvia una scansione sullo scanner specificato e restituisce una promessa che viene risolta con un StartScanResponse. Se viene utilizzata una funzione di callback, l'oggetto viene passato a quest'ultima. Se la chiamata è andata a buon fine, la risposta include un handle del job che può essere utilizzato nelle chiamate successive per leggere i dati di scansione o annullare una scansione.

Parametri

  • scannerHandle

    stringa

    La maniglia di uno scanner aperto. Questo deve essere un valore restituito in precedenza da una chiamata a openScanner.

  • Un oggetto StartScanOptions che indica le opzioni da utilizzare per la scansione. La proprietà StartScanOptions.format deve corrispondere a una delle voci restituite in ScannerInfo dello scanner.

Resi