Open EZVIZ Platform SDKUser Manual (Android)

Ezviz Studio
Ezviz Studio For Windows 7
Ezviz Studio For Pc Free Download
Ezviz Studio Zoom
Ezviz Studio Download

EZVIZ PC Studio Software. Windows PC Software. Upgrade Pack for S2 Action Camera. Upgrade Pack for S5 Plus Action Camera. Upgrade Pack for S6 Action Camera. A1S is a 100% wire-free Internet Alarm Hub that works with EZVIZ’s smart sensors and security cameras in your house. Together, these security devices alert you to any abnormal events throughout the day and night. EZVIZ PC Studio Software. Windows PC Software. Upgrade Pack for S2 Action Camera. Upgrade Pack for S5 Plus Action Camera. Upgrade Pack for S6 Action Camera. Upgrade Pack for S1C Action Camera. Video Plugin for Windows. T2 - Open/Close Detector. UV-C Air Purifier. EZVIZ connects lives through easily accessible wireless cameras, action cams, surveillance kits, and home automation tools.

Overview

Thisdocument introduces the APIs' definition and calling sequence of Open EZVIZPlatform SDK (Android).

Glossary

Term	Description
accessToken	Access token, used for client software authentication, which is returned by server
AppKey	Applying for AppKey from EZVIZ open platform
deviceSerial	Device serial No.
CameraNo	Device channel No.
deviceSerial+CameraNo	Camera ID
OSD	Video's current time
PTZ	PTZ control. You can control the device to pan, tilt, or zoom via other terminals.

Functions

Function	Description
Account operations (authorize to login, log in via SDK API)	Authorize to Open EZVIZ Platform and reuse the capability
Camera List	Get devices in the account
Live View	View the live video. You can set the resolution.
Playback (video stored in SD card or Cloud Storage)	View the recorded video files.
Two-Way Audio	Two-way audio, including half-duplex and full-duplex.
Device Settings	API for device settings.
Device Control API (PTZ, Image)	PTZ Control
Wi-Fi Configuration	Wi-Fi settings of the device.
Record during Live View and Playback	Record the video files when playing the live video and recorded videos.
Capture during Live View and Playback	Capture the images when playing the live videos and recorded videos.
Alarm Information	Get alarm information.

Project Configuration

EnvironmentSupports Android Studio 1.4 and aboveSupports JDK 7.0 and aboveSupports Android system version 4.0 and above

1. Apply for appKey

Firstly,you should apply to us about developer appkey.

2. Install SDK

SDKInstallation Steps

Get SDK via Gradle

Ifyou have installed by directly downloading in the previous, you should deletethe previously copied.so library file and .jar packet.

dependencies {

compile 'com.hikvision.ezviz:ezviz-sdk:4.8.6.2'

}

Get SDK via Repository inMaven

Ifyou have installed by directly downloading in the previous, you should deletethe previously copied.so library file and .jar packet.

<groupId>com.hikvision.ezviz</groupId>

<artifactId>ezviz-sdk</artifactId>

</dependency>

Directly Download

1.Copythe .so file in the directory of /libs/armeabi-v7a to the correspondingdirectory of your own project.2.Copy the .jar package in the directory of /libs to the correspondingdirectory of your own project (including .jmdns and .gson).

3. Configure Project

Configure AndroidPermission

Addin the file AndroidMainfest.xml:

//Network Permission

<uses-permission android:name='android.permission.INTERNET'/>

<uses-permission android:name='android.permission.ACCESS_NETWORK_STATE'/>

<uses-permission android:name='android.permission.RECORD_AUDIO'/>

<uses-permission android:name='android.permission.READ_PHONE_STATE'/>

//Storage Permission

<uses-permission android:name='android.permission.WRITE_EXTERNAL_STORAGE'/>

//Wi-Fi Status Permission

<uses-permission android:name='android.permission.ACCESS_WIFI_STATE'/>

<uses-permission android:name='android.permission.CHANGE_WIFI_STATE'/>

<uses-permission android:name='android.permission.CHANGE_WIFI_MULTICAST_STATE'/>

Configure build.gradle

defaultConfig {

...

ndk {

abiFilters 'armeabi-v7a'//Only supports v7a

}

}

sourceSets {

main {

jniLibs.srcDirs = ['libs']

}

}

Note: Currently onlysupports v7a. It can only be used in armeabi-v7a.

ndk{

abiFilters 'armeabi-v7a'//Only supports 32-bit.

}

Forpermission android.permission.READ_PHONE_STATE, you are not required to add itif not necessary.

ConfigureAndroidManifest.xml

Addthe activity definition as follows, including login, enabling cloud storage,etc.

<activity

android:name='com.videogo.main.EzvizWebViewActivity'

android:screenOrientation='portrait'

android:configChanges='orientation|keyboardHidden'>

</activity>

Addthe following broadcast receiver, which is used for receiving the networkchanges to refresh the SDK network status, for receiving the login succeededmessage to enable other pages. Replace ##you_BroadcastReceiver as the broadcastreceiver you defined in the code.

<receiver

android:name='you_BroadcastReceiver'

android:exported='false' >

<intent-filter>

</intent-filter>

</receiver>

4. Initialize Code

Itis recommended to initialize the code in the application.

/** * Enable/Disable SDK logs. */

EZGlobalSDK.showSDKLog(true);

/** * Supports P2P streaming or not. See theAPI for details. */

EZGlobalSDK.enableP2P(false);

/** * Replace the APP_KEY as the one youapplied. */

EZGlobalSDK.initLib(this,APP_KEY);

5. Code Obfuscation

Add the following contentwhen packaging.

-dontwarn com.ezviz.**

-keep class com.ezviz.** { *;}

-dontwarn com.hik.**

-keep class com.hik.** { *;}

-dontwarn com.hikvision.**

-keep class com.hikvision.** { *;}

-dontwarn com.videogo.**

-keep class com.videogo.** { *;}

-dontwarn org.MediaPlayer.PlayM4.**

-keep class org.MediaPlayer.PlayM4.** { *;}

-dontwarn com.sun.jna.**

-keep class com.sun.jna.**{*;}

# Gson Obfuscation

-keepattributes Annotation

-keep class sun.misc.Unsafe { *; }

-keep class com.idea.fifaalarmclock.entity.*

-keep class com.google.gson.stream.* { *; }

#xlog Obfuscation of mars

-keep class com.tencent.mars.** {

publicprotected private *;

}

SDK Initialization

1. InitializeAuthorization Process

For Authorized User:

Oversea:

1. The third-party servergets accessToken and expiry time via server API. accessToken is used forauthorization, expiry time is used for scheduled refresh.

2. The third-party serversends the accessToken to the third-party application (integrated with SDK). Thethird-party application calls setAccessToken (String accesstoken) to finishauthorization.

3. EZGlobalSDK.getInstance().setAccessToken(StringaccessToken);

4. Call after logoutLogout

5. EZGlobalSDK.getInstance().logout();

Or

EZGlobalSDK.getInstance().setAccessToken(null);

For the users who wantsto call the SDK login page for authorization:

1. Get area list by callingEZGlobalSDK.getInstance().getAreaList(). Select the current area's areaId andenter the login H5 page by calling EZGlobalSDK.getInstance().openLoginPage(StringareaId). You can log in to the account in this page.

2. EZGlobalSDK.getInstance().getAreaList();

3.

4. EZGlobalSDK.getInstance().openLoginPage(StringareaId)

5. After login, it will sendbroadcast. I

Ezviz Studio