Open Platform
Skip to content

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: ​

c
implementation 'com.ttlock:ttlock:3.5.7'

add permission in manifest:

c
<uses-permission android:name="android.permission.BLUETOOTH"android:maxSdkVersion="30"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"android:maxSdkVersion="30"/>
    
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />


//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);)
    
<uses-permission 
        android:name="android.permission.BLUETOOTH_SCAN"
        android:usesPermissionFlags="neverForLocation"
        tools:targetApi="s" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

Use SDK ​

  1. Before call sdk api,make sure bluetooth is enabled. ​
  2. Init sdk ​
    c
    TTLockClient.getDefault().prepareBTService(getApplicationContext());
  3. Invoke api ​

    For example:

    c
    TTLockClient.getDefault().startScanLock(new ScanLockCallback() {
        @Override
        public void onScanLockSuccess(ExtendedBluetoothDevice device) {
     
        }
    });
  4. Close SDK service ​

    When Activity finished,you should close SDK service:

    c
    TTLockClient.getDefault().stopBTService();
CopyRight © 2012-2026 Sciener.All Rights Reserved