Instructions

Software Architecture

Software architecture description

1. Lock Operate Api: TTLockClient

2. Lock firmware update Api: LockDfuClient

3. Gateway Api: GatewayClient

IDE

Android Studio

Minimum SDK Version

18

Installation

import lib in build.gradle:

xxxxxxxxxx
1
1
implementation 'com.ttlock:ttlock:3.5.7'

add permission in manifest:

xxxxxxxxxx
16
1
<uses-permission android:name="android.permission.BLUETOOTH"android:maxSdkVersion="30"/>
2
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"android:maxSdkVersion="30"/>
3
    
4
<uses-permission android:name="android.permission.BLUETOOTH" />
5
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
6
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
7
<uses-permission android:name="android.permission.INTERNET" />
8
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
9

10
//Need BLUETOOTH_SCAN and BLUETOOTH_CONNECT permissions to adapt android 31, you need to apply dynamically before calling the interface（activity.requestPermissions(new String[]{permission}, REQUEST_PERMISSION_REQ_CODE);）
11
    
12
<uses-permission 
13
        android:name="android.permission.BLUETOOTH_SCAN"
14
        android:usesPermissionFlags="neverForLocation"
15
        tools:targetApi="s" />
16
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

Use SDK

1. Before call sdk api,make sure bluetooth is enabled.

2. Init sdk

   xxxxxxxxxx
   1
   1
   TTLockClient.getDefault().prepareBTService(getApplicationContext());
   

3. Invoke api

   For example:

   xxxxxxxxxx
   6
   1
   TTLockClient.getDefault().startScanLock(new ScanLockCallback() {
   2
       @Override
   3
       public void onScanLockSuccess(ExtendedBluetoothDevice device) {
   4
    
   5
       }
   6
   });
   

4. Close SDK service

   When Activity finished,you should close SDK service:

   xxxxxxxxxx
   1
   1
   TTLockClient.getDefault().stopBTService();