Конфигурация проекта WHand

Выберите один из двух способов ниже:

Способ 1: Интеграция SDK с помощью Gradle (рекомендуется)

В файле build.gradle проекта настройте репозитории и добавьте адреса Maven или jcenter.

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

В файле build.gradle основного модуля настройте зависимости.

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    implementation 'com.github.woncan:WHand:latest.release' // где latest.release указывает на номер последней версии SDK
}

Способ 2: Импорт aar

Скачать aar Скопируйте скачанный aar-файл в директорию libs проекта. Если там уже есть старые версии aar-файлов, удалите их.

Настройте путь к сборке aar.

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation(name: 'whand-release', ext: 'aar')
}

android {
    repositories {
        flatDir {
            dirs 'libs'
        }
    }
}

Способы использования

Инициализация WHandManager

WHandManager.getInstance().init(BuildConfig.DEBUG);

Параметр включает или выключает логи SDK, в режиме отладки логи будут выводиться.

Обнаружение BluetoothDevice

Получите BluetoothDevice с помощью сканирования, для этого вам потребуются разрешения на использование Bluetooth и определение местоположения.

WHandManager.getInstance().startScan(new ScanCallback() {

    @Override
    public void onError(int errorCode, String message) {
        // Возвращает код ошибки и сообщение об ошибке
    }
});		@Override
	public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {
	    // BluetoothDevice device
		// При обнаружении BluetoothDevice будет вызван этот метод (тот же BluetoothDevice может быть обнаружен несколько раз, поэтому необходимо удалять дубликаты)
	}
});    // Сканирование по умолчанию останавливается через Options.scanPeriod (миллисекунды), но можно остановить его вручную
WHandManager.getInstance().stopScan();

Получите BluetoothDevice по Bluetooth-адресу MAC.

BluetoothAdapter.getDefaultAdapter().getRemoteDevice(mac);

Подключение к BluetoothDevice

device = WHandManager.getInstance().connect(context, bluetoothDevice); Установка слушателя состояния соединения device.setOnConnectionStateChangeListener(new OnConnectionStateChangeListener() { @Override public void onConnectionStateChange(int status, int newState) { // status представляет предыдущее состояние соединения, newState — текущее состояние соединения // всего четыре состояния соединения // BluetoothProfile.STATE_CONNECTED // BluetoothProfile.STATE_DISCONNECTED // BluetoothProfile.STATE_CONNECTING // BluetoothProfile.STATE_DISCONNECTING } }); Установка слушателя возврата данных device.setOnConnectListener(new OnConnectListener() { @Override public void onDeviceChanged(WHandInfo wHandInfo) { // возвращает информацию о устройстве, wHandInfo содержит информацию о положении и гироскопе } });

@Override
public void onAccountChanged(String name) {
}

@Override
public void onNMEAReceive(String gngga) {
    //Добавлено
    //Возврат данных GNGGA
}

@Override
public void onError(Exception e) {
    //Обратный вызов при ошибке подключения
}

});

Настройка учетной записи для дифференцирования

Выберите один из двух способов ниже

Способ 1: Использование стандартной учетной записи дифференцированияСтандартные настройки IP: rtk.ntrip.qxwz.com порт:8003 mountPoint:AUTO

device.setAccount("аккаунт", "пароль");

Способ 2: Использование пользовательской учетной записи для дифференцирования

device.setNtripConfig(ip, port, mountPoint, account, password);

WHandInfo

Примечание: Точность решения -1 Нет спутников 1 Одиночное решение 2 Кодовое дифференцирование 5 Плавающее 4 Фиксированное

Высота над уровнем моря = Высота над уровнем моря + Отклонение высоты относительно уровня моря

Дополнительные настройки

//Необходимо настроить заранее
//Установка режима отладки
Options.isDebug = BuildConfig.DEBUG;
//Установка автоматического подключения Bluetooth
Options.isAutoConnect = false;
//Установка времени сканирования Bluetooth  по умолчанию 10 секунд
Options.scanPeriod = 10 * 1000;| device API | Описание | Значение по умолчанию |

| :----- | :----: | :--: | | setAngle(int angle) | Установка угла (0°~90°) | 0 | | setInterval(int interval) | Установка интервала передачи | 200 (0.2 секунды) | | disconnect() | Отключение | | | getAccount() | Получение учетной записи | По умолчанию учетная запись отсутствует | | setAccount(String account, String password) | Установка учетной записи | | | reStartSocket() | Перезапуск сокета | | | showLaser(boolean isShow) | Установка состояния лазера | |