chrome.documentScan

중요: 이 API는 ChromeOS에서만 작동합니다.

설명

chrome.documentScan API를 사용하여 연결된 문서 스캐너에서 이미지를 검색하고 가져옵니다.

Document Scan API는 앱과 확장 프로그램이 연결된 문서 스캐너에서 종이 문서의 콘텐츠를 볼 수 있도록 설계되었습니다.

권한

documentScan

가용성

Chrome 44 이상 ChromeOS만 해당

나중에 추가된 API 구성원의 사용 가능 여부는 해당 구성원과 함께 표시됩니다.

개념 및 사용

이 API는 두 가지 문서 스캔 방법을 지원합니다. 사용 사례가 모든 스캐너에서 작동할 수 있고 구성을 제어할 필요가 없는 경우 scan() 메서드를 사용하세요. 더 복잡한 사용 사례에는 Chrome 124 이상에서만 지원되는 메서드 조합이 필요합니다.

간단한 스캔

모든 스캐너에서 작동할 수 있고 구성 제어가 필요하지 않은 간단한 사용 사례의 경우 scan()를 호출합니다. 이 메서드는 ScanOptions 객체를 사용하고 ScanResults 객체로 확인되는 프로미스를 반환합니다. 이 옵션의 기능은 스캔 수 및 호출자가 허용하는 MIME 유형으로 제한됩니다. 스캔은 사용자 인터페이스의 <img> 태그에 표시하기 위한 URL로 반환됩니다.

복잡한 검사

복잡한 검사는 이 섹션에 설명된 대로 세 단계로 실행됩니다. 이 개요에서는 응답에서 반환되는 모든 메서드 인수 또는 모든 속성을 설명하지는 않습니다. 스캐너 코드 작성에 관한 일반적인 가이드를 제공하기 위한 것입니다.

참고: openScanner(), getScannerList() 또는 startScan()을 두 번 이상 호출하면 이전에 이러한 메서드를 호출하여 시작한 작업이 취소됩니다. 자세한 내용은 이러한 메서드의 설명을 참고하세요.

디스커버리

1. getScannerList()을 호출합니다. 사용 가능한 스캐너는 GetScannerListResponse로 확인되는 프로미스로 반환됩니다.

   • 응답 객체에는 ScannerInfo 객체의 배열이 포함됩니다.
   • 스캐너가 여러 프로토콜 또는 연결 방법을 지원하는 경우 배열에 단일 스캐너에 대한 여러 항목이 포함될 수 있습니다.

2. 반환된 배열에서 스캐너를 선택하고 scannerId 속성의 값을 저장합니다.

   개별 ScannerInfo 객체의 속성을 사용하여 동일한 스캐너의 여러 객체를 구분합니다. 동일한 스캐너의 객체는 deviceUuid 속성 값이 동일합니다. ScannerInfo에는 지원되는 이미지 유형의 배열이 포함된 imageFormats 속성도 있습니다.

스캐너 구성

1. 저장된 스캐너 ID를 전달하여 openScanner()를 호출합니다. OpenScannerResponse로 확인되는 프로미스를 반환합니다. 응답 객체에는 다음이 포함됩니다.

   • 저장해야 하는 scannerHandle 속성입니다.

   • 설정해야 하는 스캐너별 속성이 포함된 옵션 속성입니다. 자세한 내용은 스캐너 옵션 검색을 참고하세요.

2. (선택사항) 사용자가 스캐너 옵션의 값을 제공해야 하는 경우 사용자 인터페이스를 만듭니다. 이전 단계에서 제공한 스캐너 옵션이 필요하며 스캐너에서 제공한 옵션 그룹을 검색해야 합니다. 자세한 내용은 사용자 인터페이스 구성을 참고하세요.

3. 프로그래매틱 또는 사용자 제공 값을 사용하여 OptionSetting 객체 배열을 구성합니다. 자세한 내용은 스캐너 옵션 설정을 참고하세요.

4. OptionSetting 객체 배열을 setOptions()에 전달하여 스캐너의 옵션을 설정합니다. SetOptionsResponse로 결정되는 Promise를 반환합니다. 이 객체에는 스캐너 구성의 1단계에서 가져온 스캐너 옵션의 업데이트된 버전이 포함되어 있습니다.

   한 옵션을 변경하면 다른 옵션의 제약 조건이 변경될 수 있으므로 이 단계를 여러 번 반복해야 할 수 있습니다.

검사

1. StartScanOptions 객체를 구성하고 startScan()에 전달합니다. StartScanResponse로 확인되는 프라미스를 반환합니다. job 속성은 스캔 데이터를 읽거나 스캔을 취소하는 데 사용할 핸들입니다.

2. 작업 핸들을 readScanData()에 전달합니다. ReadScanDataResponse 객체로 확인되는 프로미스를 반환합니다. 데이터를 성공적으로 읽은 경우 result 속성은 SUCCESS과 같고 data 속성에는 스캔의 일부가 포함된 ArrayBuffer가 포함됩니다. estimatedCompletion에는 지금까지 전송된 총 데이터의 예상 비율이 포함됩니다.

   참고: result가 SUCCESS이지만 data가 비어 있으면 readScanData()를 다시 호출하기 전에 잠시 지연합니다.

3. result 속성이 EOF 또는 오류와 같을 때까지 이전 단계를 반복합니다.

스캔이 끝나면 3단계에서 저장한 스캐너 핸들을 사용하여 closeScanner()를 호출합니다. CloseScannerResponse로 확인되는 프로미스를 반환합니다. 작업이 생성된 후 언제든지 cancelScan()를 호출하면 스캔이 종료됩니다.

응답 객체

모든 메서드는 어떤 종류의 응답 객체로 확인되는 프로미스를 반환합니다. 대부분의 경우 값이 OperationResult의 구성원인 result 속성이 포함되어 있습니다. result 값에 특정 값이 있는 경우가 아니라면 응답 객체의 일부 속성에는 값이 포함되지 않습니다. 이러한 관계는 각 응답 객체의 참조에 설명되어 있습니다.

예를 들어 OpenScannerResponse.scannerHandle은 OpenScannerResponse.result이 SUCCESS과 같은 경우에만 값을 갖습니다.

스캐너 옵션

스캐너 옵션은 기기에 따라 크게 다릅니다. 따라서 documentScan API 내에서 직접 스캐너 옵션을 반영할 수 없습니다. 이를 해결하기 위해 OpenScannerResponse (openScanner()를 사용하여 검색됨) 및 SetOptionsResponse (setOptions()의 응답 객체)에는 스캐너별 옵션을 포함하는 객체인 options 속성이 포함되어 있습니다. 각 옵션은 키-값 매핑이며, 여기서 키는 기기별 옵션이고 값은 ScannerOption의 인스턴스입니다.

구조는 일반적으로 다음과 같습니다.

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

예를 들어 'source' 및 'resolution'이라는 옵션을 반환하는 스캐너를 생각해 보세요. 반환된 options 객체의 구조는 다음 예와 같습니다. 편의상 일부 ScannerOption 응답만 표시되어 있습니다.

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

사용자 인터페이스 구성

이 API를 사용하지 않아도 되지만 사용자가 특정 옵션의 값을 선택하도록 할 수 있습니다. 이를 위해서는 사용자 인터페이스가 필요합니다. 이전 섹션에 설명된 대로 OpenScannerResponse (openScanner()로 열림)를 사용하여 연결된 스캐너의 옵션을 가져옵니다.

일부 스캐너는 기기별 방식으로 옵션을 그룹화합니다. 이러한 그룹은 옵션 동작에 영향을 주지 않지만 이러한 그룹은 스캐너의 제품 문서에 언급될 수 있으므로 사용자에게 표시되어야 합니다. getOptionGroups()를 호출하여 이러한 그룹을 검색할 수 있습니다. 그러면 GetOptionGroupsResponse 객체로 확인되는 프로미스가 반환됩니다. groups 속성에는 스캐너별 그룹 배열이 포함됩니다. 이러한 그룹의 정보를 사용하여 표시할 OpenScannerResponse의 옵션을 정리합니다.

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

스캐너 구성에 설명된 대로 한 옵션을 변경하면 다른 옵션의 제약 조건이 변경될 수 있습니다. 이것이 setOptionsResponse (setOptions()의 응답 객체)에 다른 options 속성이 포함되는 이유입니다. 이를 사용하여 사용자 인터페이스를 업데이트합니다. 그런 다음 모든 옵션이 설정될 때까지 필요에 따라 반복합니다.

스캐너 옵션 설정

OptionSetting 객체 배열을 setOptions()에 전달하여 스캐너 옵션을 설정합니다. 예를 보려면 다음 Letter 크기 페이지 1장 스캔하기 섹션을 참고하세요.

예

페이지를 blob로 가져오기

이 예에서는 스캐너에서 페이지를 blob으로 검색하는 한 가지 방법을 보여주고 OperationResult 값을 사용하여 startScan() 및 readScanData()를 사용하는 방법을 보여줍니다.

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" });
}

레터 크기 페이지 1장 스캔

이 예에서는 스캐너를 선택하고 옵션을 설정하고 여는 방법을 보여줍니다. 그런 다음 단일 페이지의 콘텐츠를 검색하고 스캐너를 닫습니다. 이 프로세스는 getScannerList(), openScanner(), setOptions(), closeScanner()를 사용하는 방법을 보여줍니다. 페이지의 콘텐츠는 이전 예시에서 pageAsBlob() 함수를 호출하여 검색됩니다.

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);
}

구성 표시

다른 곳에서 설명한 대로 사용자에게 스캐너의 구성 옵션을 표시하려면 openScanner() 호출에서 반환된 스캐너 옵션 외에도 getOptionGroups()를 호출해야 합니다. 이는 제조업체가 정의한 그룹의 사용자에게 옵션을 표시할 수 있도록 하기 위함입니다. 이 예에서는 이를 수행하는 방법을 보여줍니다.

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");
      }
    }
  }
}

유형

CancelScanResponse

Chrome 125 이상

속성

• job

  문자열

  cancelScan()에 전달된 것과 동일한 작업 핸들을 제공합니다.

• 결과

  OperationResult

  백엔드의 취소 스캔 결과입니다. 결과가 OperationResult.SUCCESS 또는 OperationResult.CANCELLED이면 스캔이 취소되었으며 스캐너가 새 스캔을 시작할 준비가 된 것입니다. 결과가 OperationResult.DEVICE_BUSY이면 스캐너가 요청된 취소를 아직 처리하고 있는 것입니다. 호출자는 잠시 기다렸다가 요청을 다시 시도해야 합니다. 다른 결과 값은 다시 시도해서는 안 되는 영구 오류를 나타냅니다.

CloseScannerResponse

Chrome 125 이상

속성

• 결과

  OperationResult

  스캐너를 닫은 결과입니다. 이 값이 SUCCESS가 아니더라도 핸들은 유효하지 않으므로 추가 작업에 사용해서는 안 됩니다.

• scannerHandle

  문자열

  closeScanner에 전달된 것과 동일한 스캐너 핸들입니다.

Configurability

Chrome 125 이상

옵션을 변경하는 방법

열거형

"NOT_CONFIGURABLE"
옵션이 읽기 전용입니다.

"SOFTWARE_CONFIGURABLE"
소프트웨어에서 옵션을 설정할 수 있습니다.

"HARDWARE_CONFIGURABLE"
사용자가 스캐너의 버튼을 전환하거나 누르면 옵션을 설정할 수 있습니다.

ConnectionType

Chrome 125 이상

스캐너가 컴퓨터에 연결된 방식을 나타냅니다.

열거형

'UNSPECIFIED'

"USB"

'NETWORK'

ConstraintType

Chrome 125 이상

OptionConstraint로 표시되는 제약조건의 데이터 유형입니다.

열거형

"INT_RANGE"
OptionType.INT 값 범위에 대한 제약조건입니다. OptionConstraint의 min, max, quant 속성은 long이 되고 list 속성은 설정되지 않습니다.

"FIXED_RANGE"
OptionType.FIXED 값 범위에 대한 제약조건입니다. OptionConstraint의 min, max, quant 속성은 double가 되고 list 속성은 설정되지 않습니다.

"INT_LIST"
특정 OptionType.INT 값 목록에 대한 제약조건입니다. OptionConstraint.list 속성에는 long 값이 포함되고 다른 속성은 설정되지 않습니다.

"FIXED_LIST"
특정 OptionType.FIXED 값 목록에 대한 제약조건입니다. OptionConstraint.list 속성에는 double 값이 포함되고 다른 속성은 설정되지 않습니다.

"STRING_LIST"
특정 OptionType.STRING 값 목록에 대한 제약조건입니다. OptionConstraint.list 속성에는 DOMString 값이 포함되고 다른 속성은 설정되지 않습니다.

DeviceFilter

Chrome 125 이상

속성

• 로컬

  불리언 선택사항

  컴퓨터에 직접 연결된 스캐너만 반환합니다.

• 보안

  불리언 선택사항

  USB 또는 TLS와 같은 보안 전송을 사용하는 스캐너만 반환합니다.

GetOptionGroupsResponse

Chrome 125 이상

속성

• 그룹

  OptionGroup[] 선택사항

  result이 SUCCESS이면 스캐너 드라이버에서 제공한 순서대로 옵션 그룹 목록을 제공합니다.

• 결과

  OperationResult

  옵션 그룹을 가져온 결과입니다. this 값이 SUCCESS이면 groups 속성이 채워집니다.

• scannerHandle

  문자열

  getOptionGroups에 전달된 것과 동일한 스캐너 핸들입니다.

GetScannerListResponse

Chrome 125 이상

속성

• 결과

  OperationResult

  열거 결과입니다. 오류가 표시되더라도 부분 결과가 반환될 수 있습니다.

• 스캐너

  ScannerInfo[]

  제공된 DeviceFilter와 일치하는 스캐너 목록(비어 있을 수 있음)

OpenScannerResponse

Chrome 125 이상

속성

• 옵션

  객체 선택사항

  result이 SUCCESS인 경우 키가 기기별 옵션이고 값이 ScannerOption의 인스턴스인 키-값 매핑을 제공합니다.

• 결과

  OperationResult

  스캐너를 연 결과입니다. 이 값이 SUCCESS이면 scannerHandle 및 options 속성이 채워집니다.

• scannerHandle

  문자열 선택사항

  result이 SUCCESS이면 추가 작업에 사용할 수 있는 스캐너 핸들입니다.

• scannerId

  문자열

  openScanner()에 전달된 스캐너 ID입니다.

OperationResult

Chrome 125 이상

각 작업의 결과를 나타내는 enum입니다.

열거형

'UNKNOWN'
알 수 없는 오류 또는 일반적인 오류가 발생했습니다.

'성공'
작업이 성공했습니다.

'지원되지 않음'
작업이 지원되지 않습니다.

'취소됨'
작업이 취소되었습니다.

'DEVICE_BUSY'
기기가 사용 중입니다.

'INVALID'
메서드에 전달된 데이터 또는 인수가 유효하지 않습니다.

"WRONG_TYPE"
제공된 값이 기본 옵션의 잘못된 데이터 유형입니다.

'EOF'
더 이상 데이터를 사용할 수 없습니다.

"ADF_JAMMED"
문서 피더에 용지가 걸렸습니다.

"ADF_EMPTY"
문서 피더가 비어 있습니다.

'COVER_OPEN'
플랫베드 커버가 열려 있습니다.

'IO_ERROR'
기기와 통신하는 중에 오류가 발생했습니다.

'ACCESS_DENIED'
기기에 인증이 필요합니다.

'NO_MEMORY'
Chromebook에 작업을 완료할 만큼 충분한 메모리가 없습니다.

'UNREACHABLE'
기기에 연결할 수 없습니다.

'누락됨'
기기가 연결 해제되었습니다.

'INTERNAL_ERROR'
호출 애플리케이션이 아닌 다른 위치에서 오류가 발생했습니다.

OptionConstraint

Chrome 125 이상

속성

• list

  string[] | number[] 선택사항

• 최대

  번호 선택사항

• 분

  번호 선택사항

• quant

  번호 선택사항

• 유형

  ConstraintType

OptionGroup

Chrome 125 이상

속성

• 멤버

  문자열[]

  드라이버가 제공한 순서의 옵션 이름 배열입니다.

• 제목

  문자열

  'Geometry options'와 같이 인쇄 가능한 제목을 제공합니다.

OptionSetting

Chrome 125 이상

속성

• 이름

  문자열

  설정할 옵션의 이름을 나타냅니다.

• 유형

  OptionType

  옵션의 데이터 유형을 나타냅니다. 요청된 데이터 유형은 기본 옵션의 실제 데이터 유형과 일치해야 합니다.

• 값

  문자열 | 숫자 | 불리언 | 숫자[] 선택사항

  설정할 값을 나타냅니다. autoSettable가 사용 설정된 옵션에 대해 자동 설정을 요청하려면 unset로 둡니다. value에 제공된 데이터 유형은 type와 일치해야 합니다.

OptionType

Chrome 125 이상

옵션의 데이터 유형입니다.

열거형

'UNKNOWN'
옵션의 데이터 유형을 알 수 없습니다. value 속성이 설정 해제됩니다.

"BOOL"
value 속성은 truefalse 중 하나입니다.

'INT'
부호 있는 32비트 정수입니다. value 속성은 옵션에 두 개 이상의 값이 사용되는지에 따라 long 또는 long[]입니다.

'FIXED'
해상도가 1/65535인 -32768~32767.9999 범위의 double입니다. value 속성은 옵션이 두 개 이상의 값을 사용하는지 여부에 따라 double 또는 double[] 입니다. 정확하게 표현할 수 없는 double 값은 사용 가능한 범위와 정밀도로 반올림됩니다.

"STRING"
NUL ('\0')을 제외한 모든 바이트의 시퀀스입니다. value 속성은 DOMString입니다.

'BUTTON'
이 유형의 옵션에는 값이 없습니다. 대신 이 유형의 옵션을 설정하면 스캐너 드라이버에 옵션별 부작용이 발생합니다. 예를 들어 버튼 유형 옵션은 스캐너 드라이버에서 기본값을 선택하거나 자동 문서 피더에 다음 종이로 이동하도록 지시하는 수단을 제공하는 데 사용할 수 있습니다.

'그룹'
그룹화 옵션입니다. 값 없음. 호환성을 위해 포함되어 있지만 일반적으로 ScannerOption 값으로 반환되지는 않습니다. getOptionGroups()를 사용하여 구성원 옵션이 있는 그룹 목록을 검색합니다.

OptionUnit

Chrome 125 이상

ScannerOption.unit의 데이터 유형을 나타냅니다.

열거형

'UNITLESS'
값이 단위가 없는 숫자입니다. 예를 들어 임곗값일 수 있습니다.

'PIXEL'
값은 픽셀 수입니다(예: 스캔 크기).

'BIT'
값은 비트 수입니다(예: 색상 심도).

'MM'
값은 밀리미터(예: 스캔 크기)로 측정됩니다.

'DPI'
이 값은 인치당 도트 수(예: 해상도)로 측정됩니다.

'PERCENT'
값은 밝기와 같이 백분율입니다.

'MICROSECOND'
값은 마이크로초 단위로 측정됩니다(예: 노출 시간).

ReadScanDataResponse

Chrome 125 이상

속성

• 데이터

  ArrayBuffer 선택사항

  result이 SUCCESS이면 스캔된 이미지 데이터의 다음 청크가 포함됩니다. result이 EOF인 경우 스캔된 이미지 데이터의 마지막 청크가 포함됩니다.

• estimatedCompletion

  번호 선택사항

  result이 SUCCESS인 경우 지금까지 전송된 총 스캔 데이터의 양을 추정하여 0~100 범위로 나타냅니다.

• job

  문자열

  readScanData()에 전달된 작업 핸들을 제공합니다.

• 결과

  OperationResult

  데이터 읽기의 결과입니다. 값이 SUCCESS이면 data에 읽을 준비가 된 이미지 데이터의 다음 청크 (길이가 0일 수 있음)가 포함됩니다. 값이 EOF이면 data에 이미지 데이터의 마지막 청크가 포함됩니다.

ScannerInfo

Chrome 125 이상

속성

• connectionType

  ConnectionType

  스캐너가 컴퓨터에 연결된 방식을 나타냅니다.

• deviceUuid

  문자열

  동일한 물리적 기기를 가리키는 다른 ScannerInfo 항목과 일치시키기 위한 것입니다.

• imageFormats

  문자열[]

  반환된 스캔에 대해 요청할 수 있는 MIME 유형의 배열입니다.

• 제조업체

  문자열

  스캐너 제조업체입니다.

• 모델

  문자열

  사용 가능한 경우 스캐너 모델 또는 일반 설명

• 이름

  문자열

  UI에 표시할 스캐너의 사람이 읽을 수 있는 이름입니다.

• protocolType

  문자열

  Mopria, WSD, epsonds와 같이 스캐너에 액세스하는 데 사용되는 프로토콜 또는 드라이버에 대해 사람이 읽을 수 있는 설명입니다. 이는 주로 기기가 여러 프로토콜을 지원하는 경우 사용자가 프로토콜 간에 선택할 수 있도록 하는 데 유용합니다.

• scannerId

  문자열

  특정 스캐너의 ID입니다.

• 보안

  부울

  이 속성이 true이면 TLS 또는 USB와 같은 수동 리스너가 스캐너 연결의 전송을 가로챌 수 없습니다.

ScannerOption

Chrome 125 이상

속성

• 구성 가능성

  구성 가능성

  옵션을 변경할 수 있는지 여부와 방법을 나타냅니다.

• 제약조건

  OptionConstraint 선택사항

  현재 스캐너 옵션에서 OptionConstraint를 정의합니다.

• 설명

  문자열

  옵션에 대한 자세한 설명입니다.

• isActive

  부울

  옵션이 활성 상태이며 설정하거나 검색할 수 있음을 나타냅니다. false이면 value 속성이 설정되지 않습니다.

• isAdvanced

  부울

  UI에 이 옵션이 기본적으로 표시되어서는 안 된다는 것을 나타냅니다.

• isAutoSettable

  부울

  스캐너 드라이버에서 자동으로 설정할 수 있습니다.

• isDetectable

  부울

  이 옵션을 소프트웨어에서 감지할 수 있음을 나타냅니다.

• isEmulated

  부울

  true인 경우 스캐너 드라이버에서 에뮬레이션합니다.

• 이름

  문자열

  소문자 ASCII 문자, 숫자, 대시를 사용하는 옵션 이름입니다. 발음 구별 부호는 허용되지 않습니다.

• 제목

  문자열

  인쇄 가능한 한 줄 제목입니다.

• 유형

  OptionType

  이 옵션을 설정하는 데 필요한 value 속성에 포함된 데이터 유형입니다.

• 단위

  OptionUnit

  이 옵션의 측정 단위입니다.

• 값

  문자열 | 숫자 | 불리언 | 숫자[] 선택사항

  옵션의 현재 값(해당하는 경우) 이 속성의 데이터 유형은 type에 지정된 데이터 유형과 일치해야 합니다.

ScanOptions

속성

• maxImages

  번호 선택사항

  스캔된 이미지의 허용 수입니다. 기본값은 1입니다.

• mimeTypes

  string[] 선택사항

  호출자가 허용하는 MIME 유형입니다.

ScanResults

속성

• dataUrls

  문자열[]

  이미지 태그에 'src' 값으로 전달할 수 있는 형식의 데이터 이미지 URL 배열입니다.

• mimeType

  문자열

  dataUrls의 MIME 유형입니다.

SetOptionResult

Chrome 125 이상

속성

• 이름

  문자열

  설정된 옵션의 이름을 나타냅니다.

• 결과

  OperationResult

  옵션 설정의 결과를 나타냅니다.

SetOptionsResponse

Chrome 125 이상

속성

• 옵션

  객체 선택사항

  제공된 모든 옵션을 설정하려고 시도한 후 새 구성이 포함된 옵션 이름에서 ScannerOption 값으로 업데이트된 키-값 매핑입니다. 이는 OpenScannerResponse의 options 속성과 동일한 구조를 갖습니다.

  이 속성은 일부 옵션이 제대로 설정되지 않은 경우에도 설정되지만 업데이트된 구성을 가져오는 데 실패하면 설정이 해제됩니다 (예: 스캔 중 스캐너의 연결이 끊긴 경우).

• 결과

  SetOptionResult[]

  전달된 각 OptionSetting에 대해 하나씩 결과 배열입니다.

• scannerHandle

  문자열

  setOptions()에 전달된 스캐너 핸들을 제공합니다.

StartScanOptions

Chrome 125 이상

속성

• 형식

  문자열

  스캔된 데이터를 반환할 MIME 유형을 지정합니다.

• maxReadSize

  번호 선택사항

  0이 아닌 값을 지정하면 단일 readScanData 응답에서 반환되는 최대 스캔된 바이트를 해당 값으로 제한합니다. 허용되는 최소값은 32768 (32KB)입니다. 이 속성을 지정하지 않으면 반환된 청크의 크기가 전체 스캔된 이미지만큼 클 수 있습니다.

StartScanResponse

Chrome 125 이상

속성

• job

  문자열 선택사항

  result이 SUCCESS이면 스캔 데이터를 읽거나 작업을 취소하는 데 사용할 수 있는 핸들을 제공합니다.

• 결과

  OperationResult

  스캔 시작 결과입니다. this 값이 SUCCESS이면 job 속성이 채워집니다.

• scannerHandle

  문자열

  startScan()에 전달된 것과 동일한 스캐너 핸들을 제공합니다.

메서드

cancelScan()

Promise Chrome 125 이상

chrome.documentScan.cancelScan(
  job: string,
  callback?: function,
)

시작된 스캔을 취소하고 CancelScanResponse 객체로 확인되는 프로미스를 반환합니다. 콜백이 사용되면 객체가 대신 전달됩니다.

매개변수

• job

  문자열

  이전에 startScan 호출에서 반환된 활성 스캔 작업의 핸들입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: CancelScanResponse) => void

  • 응답

    CancelScanResponse

반환 값

• Promise<CancelScanResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

closeScanner()

Promise Chrome 125 이상

chrome.documentScan.closeScanner(
  scannerHandle: string,
  callback?: function,
)

전달된 핸들을 사용하여 스캐너를 닫고 CloseScannerResponse 객체로 확인되는 프로미스를 반환합니다. 콜백이 사용되면 객체가 대신 전달됩니다. 응답이 성공적이지 않더라도 제공된 핸들은 무효화되며 추가 작업에 사용해서는 안 됩니다.

매개변수

• scannerHandle

  문자열

  이전에 openScanner 호출에서 반환된 열린 스캐너의 핸들을 지정합니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: CloseScannerResponse) => void

  • 응답

    CloseScannerResponse

반환 값

• Promise<CloseScannerResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getOptionGroups()

Promise Chrome 125 이상

chrome.documentScan.getOptionGroups(
  scannerHandle: string,
  callback?: function,
)

이전에 openScanner로 연 스캐너에서 그룹 이름과 구성원 옵션을 가져옵니다. 이 메서드는 GetOptionGroupsResponse 객체로 확인되는 프로미스를 반환합니다. 이 함수에 콜백이 전달되면 반환된 데이터가 대신 전달됩니다.

매개변수

• scannerHandle

  문자열

  openScanner 호출에서 반환된 열린 스캐너의 핸들입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: GetOptionGroupsResponse) => void

  • 응답

    GetOptionGroupsResponse

반환 값

• Promise<GetOptionGroupsResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getScannerList()

Promise Chrome 125 이상

chrome.documentScan.getScannerList(
  filter: DeviceFilter,
  callback?: function,
)

사용 가능한 스캐너 목록을 가져오고 GetScannerListResponse 객체로 확인되는 프로미스를 반환합니다. 이 함수에 콜백이 전달되면 반환된 데이터가 대신 전달됩니다.

매개변수

• filter

  DeviceFilter

  반환해야 하는 스캐너 유형을 나타내는 DeviceFilter입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: GetScannerListResponse) => void

  • 응답

    GetScannerListResponse

반환 값

• Promise<GetScannerListResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

openScanner()

Promise Chrome 125 이상

chrome.documentScan.openScanner(
  scannerId: string,
  callback?: function,
)

독점 액세스를 위해 검사기를 열고 OpenScannerResponse 객체로 확인되는 프로미스를 반환합니다. 이 함수에 콜백이 전달되면 반환된 데이터가 대신 전달됩니다.

매개변수

• scannerId

  문자열

  열려는 스캐너의 ID입니다. 이 값은 이전에 getScannerList를 호출할 때 반환된 값입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: OpenScannerResponse) => void

  • 응답

    OpenScannerResponse

반환 값

• Promise<OpenScannerResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

readScanData()

Promise Chrome 125 이상

chrome.documentScan.readScanData(
  job: string,
  callback?: function,
)

활성 작업 핸들에서 사용 가능한 이미지 데이터의 다음 청크를 읽고 ReadScanDataResponse 객체로 확인되는 Promise를 반환합니다. 콜백이 사용되면 객체가 대신 전달됩니다.

**참고:**응답 결과가 길이가 0인 data 구성원이 있는 SUCCESS인 것은 유효합니다. 즉, 스캐너가 아직 작동 중이지만 아직 추가 데이터가 준비되지 않았습니다. 발신자는 잠시 기다렸다가 다시 시도해야 합니다.

스캔 작업이 완료되면 응답의 결과 값은 EOF입니다. 이 응답에는 0이 아닌 최종 data 구성원이 포함될 수 있습니다.

매개변수

• job

  문자열

  이전에 startScan에서 반환된 활성 작업 핸들입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: ReadScanDataResponse) => void

  • 응답

    ReadScanDataResponse

반환 값

• Promise<ReadScanDataResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

scan()

Promise

chrome.documentScan.scan(
  options: ScanOptions,
  callback?: function,
)

문서 스캔을 실행하고 ScanResults 객체로 확인되는 프로미스를 반환합니다. 이 함수에 콜백이 전달되면 반환된 데이터가 대신 전달됩니다.

매개변수

• 옵션

  ScanOptions

  스캔 매개변수를 포함하는 객체입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: ScanResults) => void

  • 결과

    ScanResults

반환 값

• Promise<ScanResults>

  Chrome 96 이상

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setOptions()

Promise Chrome 125 이상

chrome.documentScan.setOptions(
  scannerHandle: string,
  options: OptionSetting[],
  callback?: function,
)

지정된 스캐너에 옵션을 설정하고 전달된 OptionSetting 객체의 순서대로 모든 값을 설정하려는 시도의 결과가 포함된 SetOptionsResponse 객체로 확인되는 프로미스를 반환합니다. 콜백이 사용되면 객체가 대신 전달됩니다.

매개변수

• scannerHandle

  문자열

  옵션을 설정할 스캐너의 핸들입니다. 이는 이전에 openScanner 호출에서 반환된 값이어야 합니다.

• 옵션

  OptionSetting[]

  스캐너에 적용할 OptionSetting 객체 목록입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: SetOptionsResponse) => void

  • 응답

    SetOptionsResponse

반환 값

• Promise<SetOptionsResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

startScan()

Promise Chrome 125 이상

chrome.documentScan.startScan(
  scannerHandle: string,
  options: StartScanOptions,
  callback?: function,
)

지정된 스캐너에서 스캔을 시작하고 StartScanResponse로 확인되는 Promise를 반환합니다. 콜백이 사용되면 객체가 대신 전달됩니다. 호출이 성공하면 후속 호출에서 스캔 데이터를 읽거나 스캔을 취소하는 데 사용할 수 있는 작업 핸들이 응답에 포함됩니다.

매개변수

• scannerHandle

  문자열

  열려 있는 스캐너의 핸들입니다. 이는 이전에 openScanner 호출에서 반환된 값이어야 합니다.

• 옵션

  StartScanOptions

  스캔에 사용할 옵션을 나타내는 StartScanOptions 객체입니다. StartScanOptions.format 속성은 스캐너의 ScannerInfo에 반환된 항목 중 하나와 일치해야 합니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (response: StartScanResponse) => void

  • 응답

    StartScanResponse

반환 값

• Promise<StartScanResponse>

  Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.