DoorbellWizard (v3.1)

Hints:
  • iOS specific: DoorbellWizard's callback onPreparedForConnection returns nothing.
  • iOS specific:DoorbellWizard's method connectToCamera takes no parameters. User should connect to Wifi via Settings app, then return to app and call this method.
  • iOS specific:For iOS12 and higher you should add Access Wifi Information capability (Target Name - Capabilities) in order to use DoorbellWizard otherwise iOS would not grant SDK access to Wifi information.
  • Android specific: DoorbellWizard's callback onPreparedForConnection returns list of available Doorbell Wifi Networks.
  • Android specific: DoorbellWizard's method connectToCamera takes WifiNetwork object (returned with onPreparedForConnection callback) as input parameter.
  • Android specific: DoorbellWizard's has additional method disconnectFromDoorbellWifi.

class DoorbellWizard

DoorbellWizard(DoorbellWizardDelegate delegate);

Constructs DoorbellWizard instance.

prepareForConnection(Map<String, void *> options);

Prepares for connection process. Options map should contain "cameraId" (of disconnected camera) for restoration process or "zoneId" for adding process.

connectToCamera(WifiNetwork doorbellWifiNetwork);

Connects to wifi network of chosen Doorbell. For mode details about WifiNetwork class check NuboCamWizard page.

iOS specific: user should connect to Doorbell wifi network manually using Settings app. After returning to app he should call this method (without parameters).

Android specific: list of available wifi networks is returned by prepareForConnection callback. User should use one of returned object to pass as parameter of this function.

refreshWifiList();

Refreshes list of WifiNetwork objects to which Doorbell can be connected.

connectCameraToNetwork(WifiNetwork wifiNetwork, String cameraName);

Connects Doorbell to provided wifi network with given camera name.

cancelCurrentOperation();

Cancels current operation. No callbacks will be triggered.

disconnectFromDoorbellWifi();

Android specific: Disconnects device from Doorbell's Wi-Fi access point.

protocol DoorbellWizardDelegate

@required onPreparedForConnection(WifiNetwork[] doorbellWifiNetworks);

Called when SDK is ready for Doorbell connection.

Android specific: returns list of available Doorbell wifi networks to connect. One of objects should be used with connectToCamera method.

@required onConnectedToCamera();

Called when SDK established connection with Doorbell. Now user can retrieve list of wifi. 

@optional onWifiListRefreshed(WifiNetwork[] networks);

Returns list of Wifi networks to which Doorbell can be connected.

@required onFinished(Long cameraId);

If everything went ok, will get called after the Doorbell has been added/restored.

@required onError(MobileSDKError error);

Will get called if there's an error in the process of adding/restoring Doorbell.