开放式球形相机制造商指南
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
2.1 版
简介
开放式球形相机 (OSC) 制造商指南为内置 Wi-Fi 的相机的制造商提供了球形相机 API 实现指南。如需查看完整的命令集，请参阅 OSC API 规范。
反馈
我们期待收到您对这些文档提出的改进建议。
无论您是遇到工程难题，文档令人困惑，还是出现意外行为，请告诉我们。
报告问题或提交反馈和建议。
发现广告系列
发现流程的工作原理如下：相机服务于一个可检测到的、受密码保护的 Wi-Fi 网络。手机或其他计算设备上运行的客户端软件会扫描此类网络，并显示已发现的网络服务集标识符 (SSID)，用户可以从中选择一个。用户输入所选网络的密码以进行身份验证，并将客户端软件与相机的服务器连接。
相机通过定义简单易懂的 SSID（用于向客户端唯一标识相机）来实现发现流程。相机的服务器进行身份验证，并在端口 80 上通过 HTTP 与客户端进行通信。
SSID 和密码
Wi-Fi SSID 以用户易于理解的名称开头（最多 20 个字符），并在后缀 OSC 前使用英文句点 (.) 作为分隔符。在名称末尾添加一个随机的唯一元素，有助于防止名称冲突。例如，VendorCamera123.OSC;，其中 123 从同一制造商生产的同一型号的附近相机中唯一标识当前相机。
相机 WLAN 需要 WPA2-PSK 保护。WPA2-PSK 要求的密码长度至少为 8 个字符。密码可以包含字母、数字和符号，但不能有空格。仅当相机连接到客户端设备时，用户才能更改此设置。更改密码后，相机会断开连接，并且客户端必须使用新密码重新连接。
相机必须提供重置方法，以防用户忘记了密码；例如，在相机上提供用于恢复出厂默认密码的重置按钮。
IP 地址和端口
相机的 IP 地址（例如 192.168.1.1）是相机 Wi-Fi 网络的网关 IP 地址，可以从客户端的 Wi-Fi 连接获取。对于端口，请使用 HTTP 的默认端口 80（从 /osc/info 中的端点获取用于更新的端口；请参阅 OSC 协议 > 信息）。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\u003cp\u003eThe Open Spherical Camera (OSC) API provides implementation guidance for manufacturers of WiFi-enabled spherical cameras, enabling communication with client software.\u003c/p\u003e\n"],["\u003cp\u003eCamera discovery involves the camera broadcasting a unique WiFi SSID, allowing client devices to connect after user authentication with a password.\u003c/p\u003e\n"],["\u003cp\u003eThe camera's WiFi SSID incorporates a user-friendly name, a unique identifier, and the suffix ".OSC", with WPA2-PSK security requiring a password of at least 8 characters.\u003c/p\u003e\n"],["\u003cp\u003eA reset mechanism is essential for password recovery, restoring the camera to its factory default settings.\u003c/p\u003e\n"],["\u003cp\u003eCommunication with the camera occurs via HTTP on port 80, using the camera's IP address (obtained from the WiFi connection) and potentially other ports for updates as specified in the camera's info endpoint.\u003c/p\u003e\n"]]],["Cameras serve a password-protected WiFi network, discoverable via its SSID. The SSID starts with a user-friendly name (max 20 characters), followed by \".OSC\" and a unique identifier. WPA2-PSK protection is mandatory, with passwords at least 8 characters long and changeable by the user. Cameras must have a reset method for forgotten passwords. The camera's IP is the WiFi gateway address, and HTTP communication uses port 80 by default. The port for updates is available in the /osc/info endpoint.\n"],null,["# Open Spherical Camera Manufacturer Guide\n\nVersion 2.1\n\nIntroduction\n------------\n\nThe Open Spherical Camera (OSC) Manufacturer's Guide provides spherical camera\nAPI implementation guidance for manufacturers of cameras with built-in WiFi.\nPlease refer to the\n[OSC API Specification](/streetview/open-spherical-camera/reference)\nfor the full set of commands.\n\nFeedback\n--------\n\nWe look forward to receiving your suggested improvements for these documents.\nWhether you've encountered engineering pain points, confusing documentation, or\nunexpected behavior, please let us know.\nReport an issue or submit\nfeedback and suggestions.\n\nDiscovery\n---------\n\nDiscovery flow works as follows: the camera serves a discoverable, password\nprotected, WiFi network. Client software running on a phone or other computing\ndevice scans for such networks and displays a list of discovered network Service\nSet Identifiers (SSIDs), from which the user can select one. The user enters the\nselected network's password to authenticate and connect the client software with\nthe camera's server.\n\nThe camera implements discovery flow by defining a human-readable SSID that\nuniquely identifies the camera to a client. The camera's server authenticates\nand communicates with a client via HTTP on port 80.\n\nSSID and password\n-----------------\n\nThe WiFi SSID begins with a user friendly name (20 characters maximum), with a\nperiod (.) delimiter before the suffix, `OSC`. Adding a random, unique element\nto the end of the name helps prevent name collisions. For example,\n`VendorCamera123.OSC;` where `123` uniquely identifies the current camera from\nnearby cameras of the same model, from the same manufacturer.\n\nCamera WiFi *requires* WPA2-PSK protection. WPA2-PSK requires passwords that are\nat least 8 characters long. Password can contain letters, numbers, and symbols,\nbut no spaces. Users can change it only when the camera is connected to a client\ndevice. Once it is changed, the camera disconnects and the client must reconnect\nusing the new password.\n\nThe camera ***must*** provide a reset method in case the user forgets the\npassword; for example, a reset button on the camera to restore the factory\ndefault password.\n\nIP address and port\n-------------------\n\nThe camera's IP address (e.g. 192.168.1.1) is the gateway IP address of\nthe camera's wifi network, which can be obtained from the wifi connection on the\nclient side. For port, please use default port 80 for HTTP (obtain the port for\nupdates from *endpoints* in `/osc/info`; see\n[OSC Protocol \\\u003e Info](/streetview/open-spherical-camera/guides/osc/info#endpoints_object))."]]
