camera.startCapture
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
بسته به مقدار captureMode در Options ، فیلمبرداری یا ضبط تصویر فاصله ای را شروع می کند. این دستور در سطح 2 API اضافه شده است.
پارامترها
- این دستور هیچ پارامتری در بدنه درخواست ندارد. این که آیا این عکس برداری فاصله ای باشد یا فیلم برداری با گزینه
captureMode تعیین می شود. برای ضبط بازه ای، باز بودن یا نبودن آن بستگی به این دارد که captureNumber برابر یا بزرگتر از 0 باشد. captureMode ، captureInterval و captureNumber باید قبل از ضبط فاصله تنظیم شوند. فقط captureMode باید قبل از ضبط ویدیو روی "video" تنظیم شود، که فقط با دستور camera.stopCapture می توان آن را متوقف کرد.
نتایج
- عکسبرداری با پایان باز (وقتی captureMode == "ویدئو" یا captureNumber == 0)
- ضبط بازه های بدون پایان:
- fileUrls: فهرستی از URLهای مطلق که به فایل های تصویری برای ضبط فاصله اشاره می کند. لطفاً توجه داشته باشید که این دستور بلافاصله
fileUrls بر نمی‌گرداند، زیرا برای تکمیل گرفتن captureNumber طول می‌کشد. پیشرفت دستور را می توان با نظرسنجی دوره ای دوربین به دست آورد. به عنوان مثال، نظرسنجی پس از مدت زمان تخمینی ( time = captureInterval * (captureNumber - 1) ) با استفاده از /osc/commands/status API و fileUrls نتیجه ای است که پس از پایان فرمان برمی گردد. اگر فرمان با موفقیت به پایان نرسید (مثلاً فقط 3 مورد از تصاویر قبل از تمام شدن باتری دوربین گرفته شده است) یا دوربین در وسط از تلفن مشتری جدا شده باشد، اما دستور با موفقیت به پایان برسد، مشتری باید بتواند برای به دست آوردن تصاویر با استفاده از camera.listFiles بعداً هنگامی که یک اتصال جدید بین مشتری و دوربین برقرار شد.
خطاها
- disabledCommand: فرمان در حال حاضر غیرفعال است. به عنوان مثال، دوربین در وسط یک فیلم برداری یا یک فیلم برداری فاصله ای قرار دارد.
- invalidParameterName: نام پارامتر ناشناخته است. برای مثال
sessionId شناسایی نمی شود.
دستور I/O |
|---|
| ورودی فرمان | none |
خروجی فرمان | {
"results": {
"fileUrls":[
"url1",
"url2",
"url3",
...
"urln"
]
}
} | | خروجی فرمان (خطا) | {
"error": {
"code": "disabledCommand",
"message": "Command is currently disabled."
}
} |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eInitiates either video or interval image capture based on pre-set capture mode.\u003c/p\u003e\n"],["\u003cp\u003eFor interval capture, \u003ccode\u003ecaptureMode\u003c/code\u003e, \u003ccode\u003ecaptureInterval\u003c/code\u003e, and \u003ccode\u003ecaptureNumber\u003c/code\u003e options must be configured beforehand.\u003c/p\u003e\n"],["\u003cp\u003eFor video capture, only \u003ccode\u003ecaptureMode\u003c/code\u003e needs to be set to "video" and can be stopped using the \u003ccode\u003ecamera.stopCapture\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eThe command results for non-open-ended interval capture include a list of image URLs accessible after capture completion, retrievable via polling or \u003ccode\u003ecamera.listFiles\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eErrors like "disabledCommand" occur if the camera is already capturing or "invalidParameterName" if an unrecognized parameter is used.\u003c/p\u003e\n"]]],["This command initiates video or interval image capture based on the `captureMode` setting. For interval capture, `captureNumber` determines if it's open-ended; `captureInterval` and `captureNumber` must be preset. Video capture, set by `captureMode`, is ended via `camera.stopCapture`. Open-ended capture has no immediate results. Non-open-ended interval capture eventually provides a `fileUrls` list, accessible after the completion time or if interrupted. Errors include `disabledCommand` and `invalidParameterName`. The command's input is null, and output results with file URLs.\n"],null,["# camera.startCapture\n\nStarts video capture or interval image capture depending on value of\n`captureMode` in [Options](/streetview/open-spherical-camera/reference/options).\n**This command was added in API level 2.**\n\nParameters\n----------\n\n- This command has no parameter in request body. Whether it is interval image capture or video capture is determined by `captureMode` option. For interval capture, whether it is open ended capture or not depends on whether `captureNumber` is equal to or larger than 0. `captureMode`, `captureInterval` and `captureNumber` need to be set prior to interval capture. Only `captureMode` needs to be set to \"video\" prior to video capture, which can only be stopped by [camera.stopCapture](/streetview/open-spherical-camera/reference/camera/stopcapture) command.\n\nResults\n-------\n\n- Open-ended capture (when captureMode == \"video\" or captureNumber == 0)\n - No results.\n- Non-open-ended interval capture:\n - **fileUrls:** A list of absolute URLs, pointing to image files for interval capture. Please note this command doesn't return `fileUrls` immediately since the capture takes `captureNumber` to complete. The progress of the command can be obtained by polling the camera periodically. For example, poll after an estimated duration (`time = captureInterval * (captureNumber - 1)`) using the [/osc/commands/status](/streetview/open-spherical-camera/guides/osc/commands/status) API and `fileUrls` is the result returned when the command finishes. If the command doesn't finish successfully (e.g. only 3 out of images were taken before the camera runs out of battery) or the camera is disconnected from the client phone in the middle, but the command does finish successfully, the client should be able to obtain the images using the [camera.listFiles](/streetview/open-spherical-camera/reference/camera/listfiles) later when a new connection is established between the client and the camera.\n\nErrors\n------\n\n- **disabledCommand:** Command is currently disabled; for example, the camera is in the middle of a video capture or an interval capture.\n- **invalidParameterName:** The parameter name is unrecognized; for example, `sessionId` is not recognized.\n\n| Command I/O ----------- ||\n|----------------------------|-----------------------------------------------------------------------------------------------------|\n| **Command Input** | ```text none ``` |\n| **Command Output** | ```text { \"results\": { \"fileUrls\":[ \"url1\", \"url2\", \"url3\", ... \"urln\" ] } } ``` |\n| **Command Output (Error)** | ```text { \"error\": { \"code\": \"disabledCommand\", \"message\": \"Command is currently disabled.\" } } ``` |"]]
