कोई भी काफ़ी ऐडवांस टेक्नोलॉजी, जादू से कम नहीं होती. जब तक आपको यह समझ न आ जाए. मेरा नाम थॉमस स्टाइनर है. मैं Google में डेवलपर रिलेशंस टीम में काम करता हूं. Google I/O में हुई मेरी बातचीत के इस लेख में, मैं कुछ नए Fugu एपीआई के बारे में बताऊंगा. साथ ही, यह भी बताऊंगा कि वे Excalidraw पीडब्ल्यूए में उपयोगकर्ता के मुख्य अनुभव को कैसे बेहतर बनाते हैं. इससे आपको इन आइडिया से प्रेरणा लेने और उन्हें अपने ऐप्लिकेशन में लागू करने में मदद मिलेगी.
मैंने Excalidraw का इस्तेमाल कैसे शुरू किया
मैं एक कहानी से शुरुआत करना चाहता हूं. Facebook में सॉफ़्टवेयर इंजीनियर, क्रिस्टोफ़र शेडो ने 1 जनवरी, 2020 को एक छोटे से ड्रॉइंग ऐप्लिकेशन के बारे में ट्वीट किया. उन्होंने इस ऐप्लिकेशन पर काम करना शुरू कर दिया था. इस टूल की मदद से, बॉक्स और ऐरो बनाए जा सकते थे. ये बॉक्स और ऐरो, कार्टून जैसे और हाथ से बनाए गए लगते थे. अगले दिन, आपको एलिप्स और टेक्स्ट बनाने के साथ-साथ, ऑब्जेक्ट चुनने और उन्हें इधर-उधर ले जाने की सुविधा भी मिल सकती है. तीन जनवरी को इस ऐप्लिकेशन को Excalidraw नाम मिला. हर अच्छे साइड प्रोजेक्ट की तरह, क्रिस्टोफ़र ने सबसे पहले डोमेन नेम खरीदा. अब तक, रंगों का इस्तेमाल किया जा सकता था और पूरी ड्रॉइंग को PNG के तौर पर एक्सपोर्ट किया जा सकता था.

क्रिस्टोफ़र ने 15 जनवरी को एक ब्लॉग पोस्ट डाली, जिसने Twitter पर काफ़ी लोगों का ध्यान खींचा. इसमें मैं भी शामिल था. पोस्ट की शुरुआत कुछ शानदार आंकड़ों से हुई:
- 12 हज़ार यूनीक सक्रिय उपयोगकर्ता
- GitHub पर 1.5 हज़ार स्टार मिले हैं
- 26 contributors
सिर्फ़ दो हफ़्ते पहले शुरू हुए प्रोजेक्ट के लिए, यह काफ़ी अच्छा है. लेकिन जिस चीज़ ने वाकई मेरी दिलचस्पी बढ़ाई, वह पोस्ट में और नीचे थी. क्रिस्टोफ़र ने लिखा कि इस बार उन्होंने कुछ नया करने की कोशिश की: पुल का अनुरोध करने वाले हर व्यक्ति को बिना किसी शर्त के कमिट ऐक्सेस दिया. ब्लॉग पोस्ट पढ़ने के उसी दिन, मैंने एक पुल का अनुरोध किया. इससे Excalidraw में फ़ाइल सिस्टम Access API की सुविधा जोड़ी गई. साथ ही, किसी व्यक्ति ने सुविधा का अनुरोध किया था उसे ठीक किया गया.

मेरे पुल अनुरोध को एक दिन बाद मर्ज कर दिया गया. इसके बाद, मुझे कमिट करने का पूरा ऐक्सेस मिल गया. यह कहने की ज़रूरत नहीं है कि मैंने अपनी ताकत का गलत इस्तेमाल नहीं किया. साथ ही, अब तक योगदान देने वाले 149 लोगों में से किसी ने भी ऐसा नहीं किया.
आज, Excalidraw एक ऐसा प्रोग्रेसिव वेब ऐप्लिकेशन है जिसे इंस्टॉल किया जा सकता है. इसमें ऑफ़लाइन मोड की सुविधा और गहरे रंग वाला मोड मौजूद है. साथ ही, फ़ाइल सिस्टम ऐक्सेस एपीआई की मदद से, फ़ाइलों को खोला और सेव किया जा सकता है.

लिपिस ने बताया कि वे Excalidraw को इतना समय क्यों देते हैं
तो यह थी मेरी कहानी कि "मैं Excalidraw तक कैसे पहुंचा". Excalidraw की कुछ शानदार सुविधाओं के बारे में बताने से पहले, मुझे पनायियोटिस का परिचय देने में खुशी हो रही है. Panayiotis Lipiridis, जिन्हें इंटरनेट पर lipis के नाम से जाना जाता है, Excalidraw में सबसे ज़्यादा योगदान देने वाले व्यक्ति हैं. हमने लिपिस से पूछा कि उन्हें Excalidraw को इतना समय देने की प्रेरणा कहां से मिलती है:
मुझे भी इस प्रोजेक्ट के बारे में क्रिस्टोफ़र के ट्वीट से पता चला. मेरा पहला योगदान, Open Color लाइब्रेरी को जोड़ना था. ये रंग आज भी Excalidraw का हिस्सा हैं. जैसे-जैसे प्रोजेक्ट आगे बढ़ा और हमें कई अनुरोध मिले, मैंने ड्रॉइंग को सेव करने के लिए बैकएंड बनाया, ताकि उपयोगकर्ता उन्हें शेयर कर सकें. यह मेरा अगला बड़ा योगदान था. हालांकि, मुझे योगदान देने की प्रेरणा इस बात से मिलती है कि जिस किसी ने भी Excalidraw का इस्तेमाल किया है वह इसे फिर से इस्तेमाल करने के बहाने ढूंढता है.
मैं lipis से पूरी तरह सहमत हूं. जिसने भी Excalidraw का इस्तेमाल किया है वह इसे दोबारा इस्तेमाल करने के बहाने ढूंढ रहा है.
Excalidraw का इस्तेमाल
अब मैं आपको Excalidraw इस्तेमाल करने का तरीका बताऊंगी. मैं कोई बहुत अच्छा कलाकार नहीं हूं, लेकिन Google I/O का लोगो काफ़ी आसान है. इसलिए, मैं इसे बनाने की कोशिश करता हूं. एक बॉक्स "i" है, एक लाइन स्लैश हो सकती है, और "o" एक सर्कल है. मैं shift को दबाकर रखता हूं, ताकि मुझे एक सही सर्कल मिले. मैं स्लैश को थोड़ा सा खिसका देता हूं, ताकि यह बेहतर दिखे. अब "i" और "o" में कुछ रंग भरते हैं. नीला रंग अच्छा है. शायद कोई और फ़िल स्टाइल? सभी सॉलिड या क्रॉस-हैच? नहीं, हैचर काफ़ी अच्छा लग रहा है. यह पूरी तरह से सही नहीं है, लेकिन Excalidraw का यही मकसद है. इसलिए, मुझे इसे सेव करने दें.
मैं 'सेव करें' आइकॉन पर क्लिक करता हूं और फ़ाइल सेव करने वाले डायलॉग बॉक्स में फ़ाइल का नाम डालता हूं. Chrome में, File System Access API का इस्तेमाल किया जा सकता है. इसलिए, इसमें फ़ाइल को डाउनलोड करने के बजाय, सीधे सेव किया जा सकता है. इसमें फ़ाइल का नाम और उसे सेव करने की जगह चुनी जा सकती है. साथ ही, अगर फ़ाइल में बदलाव किए जाते हैं, तो उन्हें उसी फ़ाइल में सेव किया जा सकता है.
मुझे लोगो बदलने दो और "i" को लाल रंग में बदलने दो. अगर मैं फिर से 'सेव करें' पर क्लिक करूं, तो मेरा बदलाव पहले की तरह ही उसी फ़ाइल में सेव हो जाएगा. सबूत के तौर पर, मैं कैनवस को मिटाकर फ़ाइल को फिर से खोलता हूं. जैसा कि आप देख सकते हैं, बदला हुआ लाल-नीला लोगो फिर से मौजूद है.
फ़ाइलों के साथ काम करना
फ़िलहाल, जिन ब्राउज़र पर File System Access API काम नहीं करता है उन पर हर बार सेव करने की प्रोसेस, डाउनलोड करने की प्रोसेस होती है. इसलिए, जब मैं बदलाव करता हूं, तो मुझे फ़ाइल के नाम में बढ़ते हुए नंबर के साथ कई फ़ाइलें मिलती हैं. ये फ़ाइलें, मेरे डाउनलोड फ़ोल्डर को भर देती हैं. हालांकि, इस कमी के बावजूद, मैं फ़ाइल को सेव कर सकता/सकती हूं.
फ़ाइलें खोलना
तो फिर इसका राज़ क्या है? फ़ाइल सिस्टम ऐक्सेस एपीआई के साथ काम करने वाले और इसके साथ काम न करने वाले अलग-अलग ब्राउज़र पर, फ़ाइलें खोलने और सेव करने की प्रोसेस कैसे काम करती है? Excalidraw में कोई फ़ाइल खोलने के लिए, loadFromJSON)() नाम के फ़ंक्शन का इस्तेमाल किया जाता है. यह फ़ंक्शन, fileOpen() नाम के फ़ंक्शन को कॉल करता है.
export const loadFromJSON = async (localAppState: AppState) => {
const blob = await fileOpen({
description: 'Excalidraw files',
extensions: ['.json', '.excalidraw', '.png', '.svg'],
mimeTypes: ['application/json', 'image/png', 'image/svg+xml'],
});
return loadFromBlob(blob, localAppState);
};
fileOpen() फ़ंक्शन, एक छोटी लाइब्रेरी से आता है. मैंने इसे browser-fs-access नाम दिया है. हम इसका इस्तेमाल Excalidraw में करते हैं. यह लाइब्रेरी, File System Access API की मदद से फ़ाइल सिस्टम का ऐक्सेस देती है. साथ ही, इसमें लेगसी फ़ॉलबैक की सुविधा भी होती है. इसलिए, इसका इस्तेमाल किसी भी ब्राउज़र में किया जा सकता है.
सबसे पहले, हम आपको एपीआई के काम करने पर, इसे लागू करने का तरीका बताते हैं. स्वीकार किए गए एमआईएमई टाइप और फ़ाइल एक्सटेंशन के बारे में तय करने के बाद, सबसे अहम हिस्सा File System Access API के फ़ंक्शन showOpenFilePicker() को कॉल करना है. यह फ़ंक्शन, फ़ाइलों का कलेक्शन या कोई एक फ़ाइल दिखाता है. यह इस बात पर निर्भर करता है कि एक से ज़्यादा फ़ाइलें चुनी गई हैं या नहीं. इसके बाद, फ़ाइल ऑब्जेक्ट पर फ़ाइल हैंडल को डालना होगा, ताकि उसे फिर से वापस लाया जा सके.
export default async (options = {}) => {
const accept = {};
// Not shown: deal with extensions and MIME types.
const handleOrHandles = await window.showOpenFilePicker({
types: [
{
description: options.description || '',
accept: accept,
},
],
multiple: options.multiple || false,
});
const files = await Promise.all(handleOrHandles.map(getFileWithHandle));
if (options.multiple) return files;
return files[0];
const getFileWithHandle = async (handle) => {
const file = await handle.getFile();
file.handle = handle;
return file;
};
};
फ़ॉलबैक लागू करने की प्रोसेस, "file" टाइप के input एलिमेंट पर निर्भर करती है. स्वीकार किए जाने वाले एमआईएमई टाइप और एक्सटेंशन के बारे में बातचीत करने के बाद, अगला चरण प्रोग्राम के हिसाब से इनपुट एलिमेंट पर क्लिक करना है, ताकि फ़ाइल खोलने वाला डायलॉग बॉक्स दिखे. जब उपयोगकर्ता एक या उससे ज़्यादा फ़ाइलें चुनता है, तो प्रॉमिस रिज़ॉल्व हो जाता है.
export default async (options = {}) => {
return new Promise((resolve) => {
const input = document.createElement('input');
input.type = 'file';
const accept = [
...(options.mimeTypes ? options.mimeTypes : []),
options.extensions ? options.extensions : [],
].join();
input.multiple = options.multiple || false;
input.accept = accept || '*/*';
input.addEventListener('change', () => {
resolve(input.multiple ? Array.from(input.files) : input.files[0]);
});
input.click();
});
};
फ़ाइलें सेव की जा रही हैं
अब बात करते हैं बचत की. Excalidraw में, सेव करने की प्रोसेस saveAsJSON() नाम के फ़ंक्शन में होती है. यह सबसे पहले, Excalidraw एलिमेंट के कलेक्शन को JSON में सीरियलाइज़ करता है. इसके बाद, JSON को ब्लॉब में बदलता है और फिर fileSave() नाम के फ़ंक्शन को कॉल करता है. यह फ़ंक्शन, browser-fs-access लाइब्रेरी से भी मिलता है.
export const saveAsJSON = async (
elements: readonly ExcalidrawElement[],
appState: AppState,
) => {
const serialized = serializeAsJSON(elements, appState);
const blob = new Blob([serialized], {
type: 'application/vnd.excalidraw+json',
});
const fileHandle = await fileSave(
blob,
{
fileName: appState.name,
description: 'Excalidraw file',
extensions: ['.excalidraw'],
},
appState.fileHandle,
);
return { fileHandle };
};
चलिए, सबसे पहले उन ब्राउज़र के लिए लागू करने का तरीका देखते हैं जिनमें File System Access API काम करता है. शुरुआत की कुछ लाइनें थोड़ी मुश्किल लग सकती हैं, लेकिन वे सिर्फ़ एमआईएमई टाइप और फ़ाइल एक्सटेंशन को मैनेज करती हैं. अगर मैंने पहले ही फ़ाइल सेव कर ली है और मेरे पास पहले से ही फ़ाइल हैंडल है, तो सेव करने का कोई डायलॉग बॉक्स दिखाने की ज़रूरत नहीं है. हालांकि, अगर फ़ाइल को पहली बार सेव किया जा रहा है, तो एक फ़ाइल डायलॉग दिखता है. साथ ही, ऐप्लिकेशन को आने वाले समय में इस्तेमाल करने के लिए, फ़ाइल हैंडल वापस मिल जाता है. इसके बाद, फ़ाइल में डेटा लिखने का काम होता है. यह काम राइटेबल स्ट्रीम के ज़रिए होता है.
export default async (blob, options = {}, handle = null) => {
options.fileName = options.fileName || 'Untitled';
const accept = {};
// Not shown: deal with extensions and MIME types.
handle =
handle ||
(await window.showSaveFilePicker({
suggestedName: options.fileName,
types: [
{
description: options.description || '',
accept: accept,
},
],
}));
const writable = await handle.createWritable();
await writable.write(blob);
await writable.close();
return handle;
};
"इस रूप में सेव करें" सुविधा
अगर मुझे पहले से मौजूद फ़ाइल हैंडल को अनदेखा करना है, तो मैं "इस रूप में सेव करें" सुविधा लागू कर सकता हूं. इससे, पहले से मौजूद फ़ाइल के आधार पर नई फ़ाइल बनाई जा सकती है. इसे दिखाने के लिए, मैं एक मौजूदा फ़ाइल खोलता हूं और उसमें कुछ बदलाव करता हूं. इसके बाद, मौजूदा फ़ाइल को ओवरराइट करने के बजाय, 'इस रूप में सेव करें' सुविधा का इस्तेमाल करके एक नई फ़ाइल बनाता हूं. इससे ओरिजनल फ़ाइल में कोई बदलाव नहीं होता.
फ़ाइल सिस्टम ऐक्सेस एपीआई के साथ काम न करने वाले ब्राउज़र के लिए, इसे लागू करने की प्रोसेस छोटी होती है. ऐसा इसलिए, क्योंकि यह सिर्फ़ download एट्रिब्यूट के साथ एक ऐंकर एलिमेंट बनाता है. इसकी वैल्यू, मनचाहा फ़ाइल नाम और ब्लॉब यूआरएल होती है. यह ब्लॉब यूआरएल, href एट्रिब्यूट की वैल्यू के तौर पर होता है.
export default async (blob, options = {}) => {
const a = document.createElement('a');
a.download = options.fileName || 'Untitled';
a.href = URL.createObjectURL(blob);
a.addEventListener('click', () => {
setTimeout(() => URL.revokeObjectURL(a.href), 30 * 1000);
});
a.click();
};
इसके बाद, ऐंकर एलिमेंट पर प्रोग्राम के हिसाब से क्लिक किया जाता है. मेमोरी लीक होने से रोकने के लिए, इस्तेमाल के बाद ब्लॉब यूआरएल को रद्द करना ज़रूरी है. यह सिर्फ़ एक डाउनलोड है, इसलिए फ़ाइल सेव करने का कोई डायलॉग बॉक्स नहीं दिखता. साथ ही, सभी फ़ाइलें डिफ़ॉल्ट Downloads फ़ोल्डर में सेव हो जाती हैं.
खींचें और छोड़ें
डेस्कटॉप पर सिस्टम इंटिग्रेशन की मेरी पसंदीदा सुविधाओं में से एक है, खींचने और छोड़ने की सुविधा. Excalidraw में, जब मैं किसी .excalidraw फ़ाइल को ऐप्लिकेशन पर ड्रॉप करता हूं, तो वह तुरंत खुल जाती है और मैं उसमें बदलाव करना शुरू कर सकता हूं. File System Access API के साथ काम करने वाले ब्राउज़र पर, मैं अपने बदलावों को तुरंत सेव भी कर सकता हूं. फ़ाइल सेव करने के डायलॉग बॉक्स पर जाने की ज़रूरत नहीं है, क्योंकि खींचने और छोड़ने की कार्रवाई से ज़रूरी फ़ाइल हैंडल मिल गया है.
ऐसा करने के लिए, फ़ाइल सिस्टम ऐक्सेस एपीआई के काम करने पर, डेटा ट्रांसफ़र आइटम पर getAsFileSystemHandle() को कॉल करें. इसके बाद, मैं इस फ़ाइल हैंडल को loadFromBlob() में पास करता हूं. आपको इसके बारे में ऊपर के कुछ पैराग्राफ़ से याद होगा. फ़ाइलों के साथ कई काम किए जा सकते हैं: उन्हें खोलना, सेव करना, ओवर-सेव करना, खींचना, और छोड़ना. मेरे सहकर्मी पीट और मैंने इन सभी तरकीबों और अन्य चीज़ों को अपने लेख में शामिल किया है. इससे आपको इन सभी चीज़ों को समझने में मदद मिलेगी.
const file = event.dataTransfer?.files[0];
if (file?.type === 'application/json' || file?.name.endsWith('.excalidraw')) {
this.setState({ isLoading: true });
// Provided by browser-fs-access.
if (supported) {
try {
const item = event.dataTransfer.items[0];
file as any.handle = await item as any
.getAsFileSystemHandle();
} catch (error) {
console.warn(error.name, error.message);
}
}
loadFromBlob(file, this.state).then(({ elements, appState }) =>
// Load from blob
).catch((error) => {
this.setState({ isLoading: false, errorMessage: error.message });
});
}
फ़ाइलें शेयर करना
फ़िलहाल, Android, ChromeOS, और Windows पर सिस्टम इंटिग्रेशन का एक और तरीका है. इसके लिए, Web Share Target API का इस्तेमाल किया जाता है. मैं Files ऐप्लिकेशन में अपने Downloads फ़ोल्डर में हूं. मुझे दो फ़ाइलें दिख रही हैं. इनमें से एक फ़ाइल का नाम untitled है और उसमें टाइमस्टैंप है. यह देखने के लिए कि इसमें क्या है, मैं तीन बिंदुओं पर क्लिक करता हूं. इसके बाद, शेयर करें पर क्लिक करता हूं. इसके बाद, दिखने वाले विकल्पों में से एक विकल्प Excalidraw है. आइकॉन पर टैप करने पर, मुझे दिखता है कि फ़ाइल में सिर्फ़ I/O का लोगो है.
इलेक्ट्रॉन के पुराने वर्शन पर Lipis
फ़ाइलों के साथ एक और काम किया जा सकता है, जिसके बारे में मैंने अभी तक नहीं बताया है. वह है, उन पर दो बार क्लिक करना. आम तौर पर, किसी फ़ाइल पर दो बार क्लिक करने से, उस फ़ाइल के एमआईएमई टाइप से जुड़ा ऐप्लिकेशन खुल जाता है. उदाहरण के लिए, .docx के लिए यह Microsoft Word होगा.
Excalidraw के पास ऐप्लिकेशन का एक Electron वर्शन हुआ करता था. यह वर्शन, इस तरह के फ़ाइल टाइप असोसिएशन के साथ काम करता था. इसलिए, जब किसी .excalidraw फ़ाइल पर दो बार क्लिक किया जाता था, तो Excalidraw Electron ऐप्लिकेशन खुल जाता था. लिपिस, जिनसे आप पहले भी मिल चुके हैं, Excalidraw Electron के क्रिएटर और डेप्रिकेटर दोनों थे. मैंने उनसे पूछा कि उन्हें ऐसा क्यों लगता है कि Electron वर्शन को बंद किया जा सकता है:
लोग शुरुआत से ही Electron ऐप्लिकेशन की मांग कर रहे थे. इसकी मुख्य वजह यह थी कि वे दो बार क्लिक करके फ़ाइलें खोलना चाहते थे. हमारा मकसद, इस ऐप्लिकेशन को ऐप स्टोर पर उपलब्ध कराना भी था. इसी दौरान, किसी ने हमें PWA बनाने का सुझाव दिया. इसलिए, हमने दोनों ही बना दिए. खुशकिस्मती से, हमें Project Fugu के एपीआई के बारे में पता चला. जैसे, फ़ाइल सिस्टम ऐक्सेस, क्लिपबोर्ड ऐक्सेस, फ़ाइल मैनेज करना वगैरह. सिर्फ़ एक क्लिक से, डेस्कटॉप या मोबाइल पर ऐप्लिकेशन इंस्टॉल किया जा सकता है. इसके लिए, Electron की ज़रूरत नहीं होती. इसलिए, Electron वर्शन को बंद करना और सिर्फ़ वेब ऐप्लिकेशन पर ध्यान देना हमारे लिए आसान फ़ैसला था. हमने इसे सबसे बेहतरीन पीडब्ल्यूए बनाने का फ़ैसला किया. इसके अलावा, अब हम Play Store और Microsoft Store पर पीडब्ल्यूए पब्लिश कर सकते हैं! यह तो बहुत बड़ी बात है!
कोई यह कह सकता है कि Electron के लिए Excalidraw को इसलिए बंद नहीं किया गया, क्योंकि Electron खराब है. ऐसा बिलकुल नहीं है. इसे इसलिए बंद किया गया, क्योंकि वेब अब काफ़ी बेहतर हो गया है. मुझे यह पसंद है!
फ़ाइल मैनेज करना
जब मैं कहता हूं कि "वेब काफ़ी बेहतर हो गया है", तो इसकी वजह फ़ाइल मैनेज करने जैसी सुविधाएं हैं.
यह macOS Big Sur का सामान्य इंस्टॉलेशन है. अब देखते हैं कि Excalidraw फ़ाइल पर राइट क्लिक करने पर क्या होता है. मैं इसे इंस्टॉल किए गए PWA, Excalidraw से खोलने का विकल्प चुन सकता हूं. बेशक, दो बार क्लिक करने से भी काम बन जाएगा. हालांकि, स्क्रीनकास्ट में दिखाने के लिए यह तरीका कम असरदार है.
यह कैसे काम करता है? सबसे पहले, ऑपरेटिंग सिस्टम को यह बताना होगा कि मेरा ऐप्लिकेशन किस तरह की फ़ाइलों को हैंडल कर सकता है. इसके लिए, वेब ऐप्लिकेशन मेनिफ़ेस्ट में file_handlers नाम के नए फ़ील्ड का इस्तेमाल किया जाता है. इसकी वैल्यू, किसी कार्रवाई और accept प्रॉपर्टी वाले ऑब्जेक्ट का ऐरे होती है. कार्रवाई से यह तय होता है कि ऑपरेटिंग सिस्टम आपके ऐप्लिकेशन को किस यूआरएल पाथ पर लॉन्च करेगा. साथ ही, स्वीकार किए जाने वाले ऑब्जेक्ट, एमआईएमई टाइप और उनसे जुड़े फ़ाइल एक्सटेंशन के की-वैल्यू पेयर होते हैं.
{
"name": "Excalidraw",
"description": "Excalidraw is a whiteboard tool...",
"start_url": "/",
"display": "standalone",
"theme_color": "#000000",
"background_color": "#ffffff",
"file_handlers": [
{
"action": "/",
"accept": {
"application/vnd.excalidraw+json": [".excalidraw"]
}
}
]
}
अगला चरण, ऐप्लिकेशन लॉन्च होने पर फ़ाइल को मैनेज करना है. ऐसा launchQueue इंटरफ़ेस में होता है, जहां मुझे setConsumer() को कॉल करके उपभोक्ता सेट करना होता है. इस फ़ंक्शन का पैरामीटर एक एसिंक्रोनस फ़ंक्शन है, जिसे launchParams मिलता है. इस launchParams ऑब्जेक्ट में, files नाम का एक फ़ील्ड होता है. इससे मुझे फ़ाइल मैनेज करने के लिए फ़ाइल हैंडल का एक कलेक्शन मिलता है. मुझे सिर्फ़ पहले वाले से मतलब है. इस फ़ाइल हैंडल से मुझे एक ब्लॉब मिलता है, जिसे मैं अपने पुराने दोस्त loadFromBlob() को पास करता हूं.
if ('launchQueue' in window && 'LaunchParams' in window) {
window as any.launchQueue
.setConsumer(async (launchParams: { files: any[] }) => {
if (!launchParams.files.length) return;
const fileHandle = launchParams.files[0];
const blob: Blob = await fileHandle.getFile();
blob.handle = fileHandle;
loadFromBlob(blob, this.state).then(({ elements, appState }) =>
// Initialize app state.
).catch((error) => {
this.setState({ isLoading: false, errorMessage: error.message });
});
});
}
अगर आपको यह जानकारी बहुत तेज़ी से मिली, तो मेरे लेख में, फ़ाइल मैनेज करने वाले एपीआई के बारे में ज़्यादा पढ़ा जा सकता है. एक्सपेरिमेंट के तौर पर उपलब्ध वेब प्लैटफ़ॉर्म की सुविधाओं का फ़्लैग सेट करके, फ़ाइल मैनेज करने की सुविधा चालू की जा सकती है. यह सुविधा, इस साल के आखिर तक Chrome में उपलब्ध हो जाएगी.
क्लिपबोर्ड इंटिग्रेशन
Excalidraw की एक और शानदार सुविधा है, क्लिपबोर्ड इंटिग्रेशन. मैं अपनी पूरी ड्रॉइंग या उसके कुछ हिस्सों को क्लिपबोर्ड में कॉपी कर सकता हूँ. अगर मेरा मन करे, तो मैं इसमें वॉटरमार्क भी जोड़ सकता हूँ. इसके बाद, मैं इसे किसी दूसरे ऐप्लिकेशन में पेस्ट कर सकता हूँ. वैसे, यह Windows 95 Paint ऐप्लिकेशन का वेब वर्शन है.
यह तरीका बेहद आसान है. मुझे सिर्फ़ कैनवस को ब्लॉब के तौर पर चाहिए. इसके बाद, मैं उसे क्लिपबोर्ड पर लिखता हूं. इसके लिए, मैं navigator.clipboard.write() फ़ंक्शन को ब्लॉब के साथ ClipboardItem वाला एक-एलिमेंट ऐरे पास करता हूं. क्लिपबोर्ड एपीआई की मदद से क्या-क्या किया जा सकता है, इस बारे में ज़्यादा जानने के लिए जेसन और मेरा लेख पढ़ें.
export const copyCanvasToClipboardAsPng = async (canvas: HTMLCanvasElement) => {
const blob = await canvasToBlob(canvas);
await navigator.clipboard.write([
new window.ClipboardItem({
'image/png': blob,
}),
]);
};
export const canvasToBlob = async (canvas: HTMLCanvasElement): Promise<Blob> => {
return new Promise((resolve, reject) => {
try {
canvas.toBlob((blob) => {
if (!blob) {
return reject(new CanvasError(t('canvasError.canvasTooBig'), 'CANVAS_POSSIBLY_TOO_BIG'));
}
resolve(blob);
});
} catch (error) {
reject(error);
}
});
};
दूसरों के साथ मिलकर काम करना
सेशन का यूआरएल शेयर करना
क्या आपको पता है कि Excalidraw में, साथ मिलकर काम करने की सुविधा भी है? एक ही दस्तावेज़ पर, अलग-अलग लोग साथ मिलकर काम कर सकते हैं. नया सेशन शुरू करने के लिए, मैं लाइव साथ मिलकर काम करने की सुविधा वाले बटन पर क्लिक करता हूँ. इसके बाद, सेशन शुरू करता हूँ. मैं सेशन का यूआरएल, अपने सहयोगियों के साथ आसानी से शेयर कर सकता हूं. ऐसा वेब शेयर एपीआई की वजह से हो पाया है, जिसे Excalidraw ने इंटिग्रेट किया है.
लाइव कोलैबोरेशन
मैंने अपने Pixelbook, Pixel 3a फ़ोन, और iPad Pro पर Google I/O लोगो पर काम करके, स्थानीय तौर पर एक साथ काम करने वाले सेशन को सिम्युलेट किया है. आप देख सकते हैं कि एक डिवाइस पर किए गए बदलाव, अन्य सभी डिवाइसों पर दिखते हैं.
मुझे सभी कर्सर इधर-उधर घूमते हुए भी दिख रहे हैं. Pixelbook का कर्सर लगातार मूव करता है, क्योंकि इसे ट्रैकपैड से कंट्रोल किया जाता है. हालांकि, Pixel 3a फ़ोन और iPad Pro टैबलेट का कर्सर इधर-उधर जंप करता है, क्योंकि मैं इन डिवाइसों को अपनी उंगली से टैप करके कंट्रोल करता हूं.
सहयोगियों के स्टेटस देखना
रीयल-टाइम में साथ मिलकर काम करने के अनुभव को बेहतर बनाने के लिए, इसमें एक आइडल डिटेक्शन सिस्टम भी काम करता है. iPad Pro के कर्सर का इस्तेमाल करने पर, मुझे हरे रंग का बिंदु दिखता है. जब मैं किसी दूसरे ब्राउज़र टैब या ऐप्लिकेशन पर स्विच करता हूँ, तो बिंदु काले रंग का हो जाता है. जब मैं Excalidraw ऐप्लिकेशन में होता हूँ, लेकिन कुछ नहीं कर रहा होता हूँ, तो कर्सर मुझे कुछ नहीं करते हुए दिखाता है. इसे तीन zZZs से दिखाया जाता है.
हमारे पब्लिकेशन को ध्यान से पढ़ने वाले लोगों को लग सकता है कि डिवाइस के इस्तेमाल न होने का पता लगाने के लिए, Idle Detection API का इस्तेमाल किया जाता है. यह एक शुरुआती प्रस्ताव है, जिस पर Project Fugu के तहत काम किया जा रहा है. स्पॉइलर अलर्ट: ऐसा नहीं है. हमने Excalidraw में इस एपीआई के आधार पर एक लागू किया था. हालांकि, आखिर में हमने पॉइंटर की गतिविधि और पेज दिखने की क्षमता को मेज़र करने के आधार पर, ज़्यादा पारंपरिक तरीका अपनाने का फ़ैसला किया.

हमने सुझाव दिया कि Idle Detection API, हमारे इस्तेमाल के उदाहरण को हल क्यों नहीं कर रहा था. Project Fugu के सभी एपीआई, ओपन सोर्स के तौर पर डेवलप किए जा रहे हैं. इसलिए, कोई भी व्यक्ति इसमें शामिल हो सकता है और अपनी बात रख सकता है!
Excalidraw को आगे बढ़ने से क्या रोक रहा है, इस बारे में लिपिस की राय
इस बारे में, मैंने लिपिस से एक आखिरी सवाल पूछा कि उनके हिसाब से, वेब प्लैटफ़ॉर्म में ऐसी कौनसी चीज़ मौजूद नहीं है जिसकी वजह से Excalidraw को आगे बढ़ने में रुकावट आ रही है:
File System Access API बेहतरीन है, लेकिन क्या आपको पता है? आजकल मेरी ज़्यादातर ज़रूरी फ़ाइलें, मेरी हार्ड डिस्क में नहीं, बल्कि मेरे Dropbox या Google Drive में होती हैं. मेरी इच्छा है कि File System Access API में, Dropbox या Google जैसे रिमोट फ़ाइल सिस्टम प्रोवाइडर के लिए एक ऐब्स्ट्रैक्शन लेयर शामिल हो, ताकि डेवलपर इसके साथ इंटिग्रेट कर सकें और कोड लिख सकें. इससे उपयोगकर्ता निश्चिंत हो सकते हैं कि उनकी फ़ाइलें, क्लाउड सेवा देने वाली उनकी भरोसेमंद कंपनी के पास सुरक्षित हैं.
मैं लिपिस से पूरी तरह सहमत हूं. मैं भी क्लाउड का इस्तेमाल करता हूं. उम्मीद है कि इसे जल्द ही लागू किया जाएगा.
टैब वाला ऐप्लिकेशन मोड
वाह! हमने Excalidraw में कई बेहतरीन एपीआई इंटिग्रेशन देखे हैं. फ़ाइल सिस्टम, फ़ाइल मैनेज करना, क्लिपबोर्ड, वेब शेयर, और वेब शेयर टारगेट. एक और बात. अब तक, मैं एक बार में सिर्फ़ एक दस्तावेज़ में बदलाव कर सकता था. अब नहीं. Excalidraw में टैब वाले ऐप्लिकेशन मोड के शुरुआती वर्शन का आनंद लें. यह कुछ ऐसा दिखता है.
मैंने इंस्टॉल किए गए Excalidraw PWA में एक मौजूदा फ़ाइल खोली है, जो स्टैंडअलोन मोड में चल रही है. अब मैं स्टैंडअलोन विंडो में एक नया टैब खोलता हूं. यह कोई सामान्य ब्राउज़र टैब नहीं, बल्कि एक पीडब्ल्यूए टैब है. इस नए टैब में, मैं कोई दूसरी फ़ाइल खोल सकता हूँ और एक ही ऐप्लिकेशन विंडो में दोनों फ़ाइलों पर अलग-अलग काम कर सकता हूँ.
टैब वाला ऐप्लिकेशन मोड, फ़िलहाल शुरुआती स्टेज में है. इसलिए, इसमें बदलाव हो सकते हैं. अगर आपको इस सुविधा में दिलचस्पी है, तो मेरे लेख में जाकर इसकी मौजूदा स्थिति के बारे में ज़रूर पढ़ें.
आखिरी हिस्सा
इस सुविधा और अन्य सुविधाओं के बारे में अप-टू-डेट रहने के लिए, हमारा Fugu API ट्रैकर ज़रूर देखें. हम वेब को आगे बढ़ाने और आपको इस प्लैटफ़ॉर्म पर ज़्यादा काम करने की सुविधा देने के लिए बेहद उत्साहित हैं. Excalidraw को लगातार बेहतर बनाने के लिए शुभकामनाएं. साथ ही, उन सभी शानदार ऐप्लिकेशन के लिए भी शुभकामनाएं जो आप बनाएंगे. excalidraw.com पर जाकर, डायग्राम बनाना शुरू करें.
मुझे यह देखने का बेसब्री से इंतज़ार है कि आज मैंने जो एपीआई दिखाए हैं उनमें से कुछ आपके ऐप्लिकेशन में कब दिखेंगे. मेरा नाम टॉम है. मुझे Twitter और इंटरनेट पर @tomayac के तौर पर ढूंढा जा सकता है. वीडियो देखने के लिए धन्यवाद. Google I/O के बाकी इवेंट का आनंद लें.