यूआरआई के आधार पर किसी फ़ाइल को मिटाता है. इस निर्देश को एपीआई लेवल 2 में बदला गया था.
पैरामीटर
- एपीआई लेवल 1
- fileUri: जिस फ़ाइल को मिटाना है उसका यूआरआई. मैन्युफ़ैक्चरर यह तय करते हैं कि पूरे यूआरआई का इस्तेमाल करना है या मिलते-जुलते यूआरआई. क्लाइंट इसे ओपेक आइडेंटिफ़ायर मान सकते हैं.
- एपीआई लेवल 2
- fileUrls: कैमरे से मिटाई जाने वाली फ़ाइलों के पूरे यूआरएल की सूची, जिन्हें पहले लिया गया था. जैसे,
camera.listFiles
याcamera.takePicture
निर्देशों से. इसके तीन खास मामले होते हैं:- सूची में सिर्फ़ स्ट्रिंग “सभी” शामिल है: कैमरे में मौजूद सभी फ़ाइलें मिटाएं.
- सूची में सिर्फ़ स्ट्रिंग “image” शामिल है: कैमरे में मौजूद सभी इमेज मिटा दें.
- सूची में सिर्फ़ स्ट्रिंग “video” शामिल है: कैमरे में मौजूद सभी वीडियो मिटा दें.
- fileUrls: कैमरे से मिटाई जाने वाली फ़ाइलों के पूरे यूआरएल की सूची, जिन्हें पहले लिया गया था. जैसे,
नतीजे
- fileUrls: उन फ़ाइलों के यूआरएल जिन्हें मिटाया नहीं गया है.
कृपया ध्यान दें कि ऐसा तब होता है, जब fileUrls में सभी यूआरएल मान्य होते हैं, लेकिन कैमरा उनमें से कुछ यूआरएल को नहीं मिटा पाता है. अगर कोई भी यूआरएल अमान्य है, तो कोई फ़ाइल मिटाए बिना, गड़बड़ी कोड
invalidParameterValue
दिखना चाहिए. इसे एपीआई लेवल 2 में जोड़ा गया था.
गड़बड़ियां
- missing पैरामीटर:
fileUri
मौजूद नहीं है. - अमान्य parameterName: इनपुट पैरामीटर का नाम, पहचाना नहीं जा सका.
- अमान्य पैरामीटर वैल्यू: इनपुट पैरामीटर का नाम सही है, लेकिन इसकी वैल्यू अमान्य है. उदाहरण के लिए, एपीआई लेवल 1 में
fileUri
मौजूद नहीं है या एपीआई लेवल 2 में fileUrls में कोई यूआरएल मौजूद नहीं है.
निर्देश I/O | |
---|---|
कमांड इनपुट (एपीआई लेवल 1) | { "parameters": { "fileUri": "file URI" } } |
कमांड आउटपुट (एपीआई लेवल 1) | none |
कमांड आउटपुट (गड़बड़ी) (एपीआई लेवल 1) | { "error": { "code": "invalidParameterName", "message": "Parameter XYZ is unrecognized." } } |
कमांड इनपुट (एपीआई लेवल 2) | { "parameters": { "fileUrls": [ "url1", "url2", "url3", ... "urln" ] } } |
कमांड आउटपुट (एपीआई लेवल 2) | { "results": { "fileUrls": [ "urln" ] } } |
कमांड आउटपुट (गड़बड़ी) (एपीआई लेवल 2) | { "error": { "code": "invalidParameterValue", "message": "Parameter url3 doesn't exist." } } |