كاميرا.حذف
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحذف ملفًا نظرًا لمعرف الموارد المنتظم (URI) الخاص به. تم تعديل هذا الأمر في المستوى 2 من واجهة برمجة التطبيقات.
المعلمات
- المستوى 1 من واجهة برمجة التطبيقات
- fileUri: معرّف موارد منتظم (URI) لملف تريد حذفه. تقرر الشركات المصنّعة
ما إذا كان سيتم استخدام معرفات الموارد المنتظمة (URI) المطلقة أو النسبية. قد يتعامل العملاء مع هذا المبلغ على أنّه معتم
المُعرف.
- مستوى واجهة برمجة التطبيقات 2
- fileUrls: قائمة بعناوين URL المطلقة للملفات المطلوب حذفها
من الكاميرا، والتي تم الحصول عليها سابقًا، على سبيل المثال من
camera.listFiles
أو camera.takePicture أوامر. هناك ثلاث حالات خاصة:
- تحتوي القائمة على سلسلة "الكل" فقط: احذف جميع الملفات في الكاميرا.
- تحتوي القائمة على سلسلة "image" فقط: احذف جميع الصور في
والكاميرا.
- تحتوي القائمة على السلسلة "فيديو" فقط: احذف جميع الفيديوهات في
والكاميرا.
النتائج
- fileUrls: عناوين URL للملفات التي لم يتم حذفها بنجاح.
يُرجى العلم أنّ هذا يحدث عندما تكون جميع عناوين URL في fileUrl صالحة ولكن يتعذّر استخدام الكاميرا.
لحذف بعضها. إذا كان أي من عناوين URL غير صالح، سيتم عرض رمز الخطأ
يجب عرض
invalidParameterValue بدون حذف أي ملف.
تمّت إضافة ذلك في المستوى 2 من واجهة برمجة التطبيقات.
الأخطاء
- غير متوفِّر: لم يتم تحديد
fileUri.
- spamparamName: لم يتم التعرُّف على اسم معلَمة الإدخال.
- invalidParameterValue: يتم التعرّف على اسم معلَمة الإدخال،
ولكن قيمتها غير صالحة؛ على سبيل المثال، لا تصل قيمة
fileUri
في المستوى 1 من واجهة برمجة التطبيقات أو أي عنوان URL في عناوين fileUrl لا يتوفّر في المستوى 2 من واجهة برمجة التطبيقات.
مفتاح Command 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."
}
} |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003edeleteFile\u003c/code\u003e command removes one or more files from the camera's storage.\u003c/p\u003e\n"],["\u003cp\u003eAPI level 1 uses \u003ccode\u003efileUri\u003c/code\u003e to specify a single file for deletion, while API level 2 uses \u003ccode\u003efileUrls\u003c/code\u003e to specify one or more files, or uses special values to delete all files, all images, or all videos.\u003c/p\u003e\n"],["\u003cp\u003eErrors are returned if parameters are missing, invalid, or if the specified files cannot be deleted.\u003c/p\u003e\n"],["\u003cp\u003eAPI level 2 introduced the \u003ccode\u003efileUrls\u003c/code\u003e parameter and the ability to return a list of unsuccessfully deleted files in the results.\u003c/p\u003e\n"]]],["This describes a command to delete files from a camera. In API level 1, it accepts a `fileUri` to delete a single file, where the URI's format is determined by the manufacturer. API level 2 was introduced to use the `fileUrls` parameter for multiple files, specified by absolute URLs. Special strings like \"all\", \"image\", or \"video\" delete all files, all images, or all videos. A list of `fileUrls` will return any files that did not delete correctly. Errors include invalid parameters or missing data.\n"],null,["# camera.delete\n\nDeletes a file given its URI. **This command was modified in API level 2.**\n\nParameters\n----------\n\n- **API level 1**\n - **fileUri:** URI of a file to delete. Manufacturers decide whether to use absolute or relative URIs. Clients may treat this as an opaque identifier.\n- **API level 2**\n - **fileUrls:** A list of absolute URLs for files to be deleted from the camera, which were obtained previously, e.g. from [camera.listFiles](/streetview/open-spherical-camera/reference/camera/listfiles) or [camera.takePicture](/streetview/open-spherical-camera/reference/camera/takepicture) commands. There are three special cases:\n - The list only contains string \"all\": delete all files in the camera.\n - The list only contains string \"image\": delete all images in the camera.\n - The list only contains string \"video\": delete all videos in the camera.\n\nResults\n-------\n\n- **fileUrls:** URLs of files that are not successfully deleted. Please note this happens when all the URLs in fileUrls are valid but camera fails to delete some of them. If any of the URLs is invalid, error code `invalidParameterValue` should be returned without deleting any file. **This was added in API level 2.**\n\nErrors\n------\n\n- **missingParameter:** `fileUri` not specified.\n- **invalidParameterName:** The input parameter name is unrecognized.\n- **invalidParameterValue:** The input parameter name is recognized, but its value is invalid; for example, the `fileUri` doesn't exist in API level 1 or any URL in fileUrls doesn't exist in API level 2.\n\n| Command I/O ----------- ||\n|------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| **Command Input (API level 1)** | ```text { \"parameters\": { \"fileUri\": \"file URI\" } } ``` |\n| **Command Output (API level 1)** | ```text none ``` |\n| **Command Output (Error) (API level 1)** | ```text { \"error\": { \"code\": \"invalidParameterName\", \"message\": \"Parameter XYZ is unrecognized.\" } } ``` |\n| **Command Input (API level 2)** | ```text { \"parameters\": { \"fileUrls\": [ \"url1\", \"url2\", \"url3\", ... \"urln\" ] } } ``` |\n| **Command Output (API level 2)** | ```text { \"results\": { \"fileUrls\": [ \"urln\" ] } } ``` |\n| **Command Output (Error) (API level 2)** | ```text { \"error\": { \"code\": \"invalidParameterValue\", \"message\": \"Parameter url3 doesn't exist.\" } } ``` |"]]
