camera.delete
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Borra un archivo según su URI. Este comando se modificó en el nivel de API 2.
Parámetros
- Nivel de API 1
- fileUri: Es el URI de un archivo que se borrará. Los fabricantes deciden
si usar URI absolutos o relativos. Los clientes pueden considerarlo como opaco.
identificador.
- Nivel de API 2
- fileUrls: Una lista de URLs absolutas de los archivos que se borrarán.
de la cámara, que se obtuvieron previamente, p.ej., de
camera.listFiles
o camera.takePicture
. Existen tres casos especiales:
- La lista solo contiene la cadena “all”: borra todos los archivos de la cámara.
- La lista solo contiene la cadena “image”: borra todas las imágenes de
cámara.
- La lista solo contiene la cadena “video”: borra todos los videos de la
cámara.
Resultados
- fileUrls: Son las URLs de los archivos que no se borraron correctamente.
Ten en cuenta que esto sucede cuando todas las URLs de fileUrls son válidas, pero la cámara falla
para borrar algunas. Si alguna de las URLs no es válida, el código de error
Se debe mostrar
invalidParameterValue
sin borrar ningún archivo.
Esto se agregó en el nivel de API 2.
Errores
- missingParameter: No se especificó
fileUri
.
- invalidParameterName: No se reconoce el nombre del parámetro de entrada.
- invalidParameterValue: Se reconoce el nombre del parámetro de entrada.
pero su valor no es válido; por ejemplo,
fileUri
no
existen en el nivel de API 1 o cualquier URL en fileUrls no existe en el nivel de API 2.
E/S de comando |
Entrada de comando (nivel de API 1) |
{
"parameters": {
"fileUri": "file URI"
}
} |
Resultado del comando (nivel de API 1) |
none |
Resultado del comando (error) (nivel de API 1) |
{
"error": {
"code": "invalidParameterName",
"message": "Parameter XYZ is unrecognized."
}
} |
Entrada de comando (nivel de API 2) |
{
"parameters": {
"fileUrls": [
"url1",
"url2",
"url3",
...
"urln"
]
}
} |
Resultado del comando (nivel de API 2) |
{
"results": {
"fileUrls": [
"urln"
]
}
} |
Resultado del comando (error) (nivel de API 2) |
{
"error": {
"code": "invalidParameterValue",
"message": "Parameter url3 doesn't exist."
}
} |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-08-21 (UTC)
[null,null,["Última actualización: 2024-08-21 (UTC)"],[[["\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.\" } } ``` |"]]