chrome.printing

Açıklama

İzinler

Kullanılabilirlik

Tüm chrome.printing yöntemleri ve etkinlikleri, uzantı manifestinde "printing" iznini beyan etmenizi gerektirir. Örneğin:

{
  "name": "My extension",
  ...
  "permissions": [
    "printing"
  ],
  ...
}

Örnekler

Aşağıdaki örnekler, yazdırma ad alanındaki yöntemlerin her birinin kullanımını göstermektedir. Bu kod, extensions-samples GitHub deposundaki api-samples/printing kodundan veya buna dayalı olarak kopyalanır.

cancelJob()

Bu örnekte, jobStatus PENDING veya IN_PROGRESS olmadığında "iptal" düğmesini gizlemek için onJobStatusChanged işleyici kullanılmaktadır. Bazı ağlarda veya bir Chromebook doğrudan yazıcıya bağlandığında bu durumların, iptal düğmesinin çok hızlı bir şekilde geçirilip çağrılabilecek kadar uzun süre görünmeyebileceğini unutmayın. Bu, son derece basitleştirilmiş yazdırma örneğidir.

chrome.printing.onJobStatusChanged.addListener((jobId, status) => {
  const cancelButton = document.getElementById("cancelButton");
  cancelButton.addEventListener('click', () => {
    chrome.printing.cancelJob(jobId).then((response) => {
      if (response !== undefined) {
        console.log(response.status);
      }
      if (chrome.runtime.lastError !== undefined) {
        console.log(chrome.runtime.lastError.message);
      }
    });
  });
  if (status !== "PENDING" && status !== "IN_PROGRESS") {
    cancelButton.style.visibility = 'hidden';
  } else {
    cancelButton.style.visibility = 'visible';
  }
}

getPrinters() and getPrinterInfo()

Yazıcı bilgilerinin alınması için getPrinters() çağrısı yapılarak alınan bir yazıcı kimliği gerektiğinden, bu işlevler için tek bir örnek kullanılmıştır. Bu örnekte, varsayılan yazıcının adı ve açıklaması konsola kaydedilir. Bu, yazdırma örneğinin basitleştirilmiş bir sürümüdür.

​​const printers = await chrome.printing.getPrinters();
const defaultPrinter = printers.find((printer) => {
  const printerInfo = await chrome.printing.getPrinterInfo(printer.id);
  return printerInfo.isDefault;
}
console.log(`Default printer: ${defaultPrinter.name}.\n\t${defaultPrinter.description}`);

submitJob()

submitJob() yöntemi için üç şey gerekir.

• Yazıcının hangi özelliklerinin kullanılacağını belirten bir ticket yapısı. Kullanıcının mevcut özellikler arasından seçim yapması gerekiyorsa bunları getPrinterInfo() kullanarak belirli bir yazıcı için alabilirsiniz.
• Kullanılacak yazıcıyı ve yazdırılacak dosyayı veya tarihi belirten bir SubmitJobRequest yapısı. Bu yapı, ticket yapısına bir referans içeriyor.
• Yazdırılacak dosyanın veya verilerin bir blob'u.

submitJob() çağrıldığında, kullanıcıdan yazdırma işlemini onaylamasını isteyen bir iletişim kutusu tetiklenir. Onayı atlamak için PrintingAPIExtensionsAllowlist öğesini kullanın.

Bu, yazdırma örneğinin basitleştirilmiş bir sürümüdür. ticket öğesinin SubmitJobRequest yapısına (8. satır) eklendiğine ve yazdırılacak verilerin bir blob'a (10. satır) dönüştürüldüğüne dikkat edin. Yazıcının kimliğinin (1. satır) elde edilmesi, örnekte burada gösterilenden daha karmaşıktır.

const defaultPrinter = getDefaultPrinter();
const ticket = getPrinterTicket(defaultPrinter);
const arrayBuffer = getPrintData();
const submitJobRequest = {
  job: {
    printerId: defaultPrinter,
    title: 'test job',
    ticket: ticket,
    contentType: 'application/pdf',
    document: new Blob([new Uint8Array(arrayBuffer)], {
      type: 'application/pdf'
    });
  }
};

chrome.printing.submitJob(submitJobRequest, (response) => {
  if (response !== undefined) {
    console.log(response.status);
  }
  if (chrome.runtime.lastError !== undefined) {
    console.log(chrome.runtime.lastError.message);
  }
});

Rulo baskı

Bu örnekte, genellikle makbuz yazdırmada kullanılan sürekli (veya rulo) yazdırma için nasıl yazıcı bileti oluşturulacağı gösterilmektedir. Rulo baskı için submitJobRequest nesnesi, submitJob() örneğinde gösterilenle aynıdır.

Kağıt kesme için varsayılan değeri değiştirmeniz gerekirse vendor_ticket_item tuşunu kullanın. (Varsayılan ayar her yazıcıdan yazıcıya değişir.) Dahil edildiğinde bu anahtarın tek üyeli bir dizi olması gerekir: id değeri 'finishings' olan bir nesne. Değer, yazdırma işleminin sonunda zarı kesen yazıcılar için 'trim' veya yazdırma işinin kesilmesini gerektiren yazıcılar için 'none' olabilir.

const ticket = {
  version: '1.0',
  print: {
    vendor_ticket_item: [{id: 'finishings', value: 'trim'}],
    color: {type: 'STANDARD_MONOCHROME'},
    duplex: {type: 'NO_DUPLEX'},
    page_orientation: {type: 'PORTRAIT'},
    copies: {copies: 1},
    dpi: {horizontal_dpi: 300, vertical_dpi: 300},
    media_size: {
      width_microns: 72320,
      height_microns: 100000
    },
    collate: {collate: false}
  }
};

Bazı yazıcılar "finishings" seçeneğini desteklemez. Yazıcınızın bunu yapıp yapmadığını belirlemek için getPrinterInfo() numaralı telefonu arayın ve "finishings/11" olarak "display_name" değeri arayın.

"vendor_capability": [
  {
    "display_name": "finishings/11",
    "id": "finishings/11",
    "type": "TYPED_VALUE",
    "typed_value_cap": {
      "value_type": "BOOLEAN"
    }
  },
  ...
]

Biletlerin media_size anahtarındaki değerler her yazıcıya özeldir. Uygun bir boyut seçmek için getPrinterInfo() numaralı telefonu arayın. Döndürülen GetPrinterResponse, "media_size"."option" konumunda desteklenen medya boyutları dizisi içeriyor. "is_continuous_feed" değeri true olan bir seçenek belirleyin. Bilet için yükseklik ve genişlik değerlerini kullanın.

"media_size": {
  "option": [
  {
    "custom_display_name": "",
    "is_continuous_feed": true,
    "max_height_microns": 2000000,
    "min_height_microns": 25400,
    "width_microns": 50800
  },
  ...
  ]
}

chrome.printing.cancelJob(
  jobId: string,
  callback?: function,
)

chrome.printing.getPrinterInfo(
  printerId: string,
  callback?: function,
)

chrome.printing.getPrinters(
  callback?: function,
)

chrome.printing.submitJob(
  request: SubmitJobRequest,
  callback?: function,
)

chrome.printing.onJobStatusChanged.addListener(
  callback: function,
)