chrome.printerProvider

설명

chrome.printerProvider API는 인쇄 관리자에서 사용되는 이벤트를 노출하여 확장 프로그램으로 제어되는 프린터를 쿼리하고 기능을 쿼리하며 이러한 프린터에 인쇄 작업을 제출합니다.

권한

printerProvider

가용성

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

유형

PrinterInfo

속성

  • 설명

    문자열(선택사항)

    프린터의 사람이 읽을 수 있는 설명입니다.

  • id

    문자열

    고유한 프린터 ID입니다.

  • 이름

    문자열

    사람이 읽을 수 있는 프린터의 이름입니다.

PrintError

onPrintRequested 이벤트에 대한 응답으로 반환되는 오류 코드입니다.

열거형

"OK"
작업이 성공적으로 완료되었음을 지정합니다.

"FAILED"
일반적인 오류가 발생했음을 나타냅니다.

"INVALID_TICKET"
인쇄 티켓이 유효하지 않음을 지정합니다. 예를 들어 티켓이 일부 기능과 일치하지 않거나 확장 프로그램이 티켓의 모든 설정을 처리할 수 없는 경우입니다.

"INVALID_DATA"
잘못된 문서임을 나타냅니다. 예를 들어 데이터가 손상되었거나 형식이 확장 프로그램과 호환되지 않습니다.

PrintJob

속성

  • contentType

    문자열

    문서 콘텐츠 유형입니다. 지원되는 형식은 "application/pdf" 및 "image/pwg-raster"입니다.

  • 문서

    blob

    인쇄할 문서 데이터가 포함된 blob입니다. 형식은 contentType과(와) 일치해야 합니다.

  • printerId

    문자열

    작업을 처리할 프린터의 ID입니다.

  • 티켓

    객체

    CJT 형식으로 티켓을 인쇄합니다.

    CJT 참조는 지원 중단된 것으로 표시됩니다. 이 기능은 Google 클라우드 프린트에서만 지원 중단되었습니다. ChromeOS 인쇄에서 지원 중단되지 않습니다.

  • 제목

    문자열

    인쇄 작업 제목입니다.

이벤트

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

인쇄 관리자가 프린터 기능을 요청하면 이벤트가 시작됩니다.

매개변수

  • 콜백

    함수

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

    (printerId: string, resultCallback: function) => void

    • printerId

      문자열

    • resultCallback

      함수

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

      (capabilities: object) => void

      • capabilities

        객체

        CDD 형식의 기기 기능입니다.

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

인쇄 관리자가 확장 프로그램에서 제공하는 프린터를 요청하면 이벤트가 실행됩니다.

매개변수

  • 콜백

    함수

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

    (resultCallback: function) => void

    • resultCallback

      함수

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

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

인쇄 관리자가 프린터일 수 있는 USB 기기에 대한 정보를 요청하면 이벤트가 시작됩니다.

참고: 애플리케이션은 기기당 두 번 이상 이 이벤트를 실행해서는 안 됩니다. 연결된 기기가 지원되는 경우 onGetPrintersRequested 이벤트에 반환되어야 합니다.

매개변수

  • 콜백

    함수

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

    (device: usb.Device, resultCallback: function) => void

    • 기기

      usb.Device

    • resultCallback

      함수

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

      (printerInfo?: PrinterInfo) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

인쇄 관리자가 인쇄를 요청하면 이벤트가 시작됩니다.

매개변수

  • 콜백

    함수

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

    (printJob: PrintJob, resultCallback: function) => void

    • printJob

      PrintJob

    • resultCallback

      함수

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

      (result: PrintError) => void