├── settings.gradle ├── screenshots ├── 1-main.png └── icon-web.png ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── Application ├── src │ └── main │ │ ├── res │ │ ├── drawable-hdpi │ │ │ ├── tile.9.png │ │ │ ├── ic_launcher.png │ │ │ └── ic_action_refresh.png │ │ ├── drawable-mdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_action_refresh.png │ │ ├── drawable-xhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_action_refresh.png │ │ ├── drawable-xxhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_action_refresh.png │ │ ├── menu-v21 │ │ │ └── scanner_menu.xml │ │ ├── values-v11 │ │ │ └── template-styles.xml │ │ ├── values-sw600dp │ │ │ ├── template-dimens.xml │ │ │ └── template-styles.xml │ │ ├── values-v21 │ │ │ ├── base-colors.xml │ │ │ └── base-template-styles.xml │ │ ├── values │ │ │ ├── base-strings.xml │ │ │ ├── template-dimens.xml │ │ │ ├── template-styles.xml │ │ │ └── strings.xml │ │ └── layout │ │ │ ├── listitem_scanresult.xml │ │ │ ├── fragment_advertiser.xml │ │ │ └── activity_main.xml │ │ ├── java │ │ └── com │ │ │ └── example │ │ │ └── android │ │ │ └── bluetoothadvertisements │ │ │ ├── Constants.java │ │ │ ├── MainActivity.java │ │ │ ├── ScanResultAdapter.java │ │ │ ├── AdvertiserFragment.java │ │ │ ├── ScannerFragment.java │ │ │ └── AdvertiserService.java │ │ └── AndroidManifest.xml └── build.gradle ├── README.md ├── .google └── packaging.yaml ├── CONTRIBUTING.md ├── gradlew.bat ├── gradlew └── LICENSE /settings.gradle: -------------------------------------------------------------------------------- 1 | include 'Application' 2 | -------------------------------------------------------------------------------- /screenshots/1-main.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/screenshots/1-main.png -------------------------------------------------------------------------------- /screenshots/icon-web.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/screenshots/icon-web.png -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /Application/src/main/res/drawable-hdpi/tile.9.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-hdpi/tile.9.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-hdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-hdpi/ic_launcher.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-mdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-mdpi/ic_launcher.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-xhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-xhdpi/ic_launcher.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-xxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-xxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-hdpi/ic_action_refresh.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-hdpi/ic_action_refresh.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-mdpi/ic_action_refresh.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-mdpi/ic_action_refresh.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-xhdpi/ic_action_refresh.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-xhdpi/ic_action_refresh.png -------------------------------------------------------------------------------- /Application/src/main/res/drawable-xxhdpi/ic_action_refresh.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/android-BluetoothAdvertisements/master/Application/src/main/res/drawable-xxhdpi/ic_action_refresh.png -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 | Android BluetoothAdvertisements Sample 3 | ====================================== 4 | 5 | This repo has been migrated to [github.com/android/connectivity][1]. Please check that repo for future updates. Thank you! 6 | 7 | [1]: https://github.com/android/connectivity 8 | 9 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Mon Mar 02 15:22:07 PST 2015 2 | distributionBase=GRADLE_USER_HOME 3 | distributionPath=wrapper/dists 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | distributionUrl=https\://services.gradle.org/distributions/gradle-4.4-all.zip -------------------------------------------------------------------------------- /Application/src/main/res/menu-v21/scanner_menu.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 8 | -------------------------------------------------------------------------------- /.google/packaging.yaml: -------------------------------------------------------------------------------- 1 | 2 | # GOOGLE SAMPLE PACKAGING DATA 3 | # 4 | # This file is used by Google as part of our samples packaging process. 5 | # End users may safely ignore this file. It has no relevance to other systems. 6 | --- 7 | status: PUBLISHED 8 | technologies: [Android] 9 | categories: [Connectivity] 10 | languages: [Java] 11 | solutions: [Mobile] 12 | github: android-BluetoothAdvertisements 13 | level: ADVANCED 14 | icon: screenshots/icon-web.png 15 | apiRefs: 16 | - android:android.bluetooth.le.BluetoothLeAdvertiser 17 | - android:android.bluetooth.le.BluetoothLeScanner 18 | license: apache2 19 | -------------------------------------------------------------------------------- /Application/src/main/res/values-v11/template-styles.xml: -------------------------------------------------------------------------------- 1 | 16 | 17 | 18 | 19 | 20 | 24 | 25 | 26 | -------------------------------------------------------------------------------- /Application/src/main/res/values/base-strings.xml: -------------------------------------------------------------------------------- 1 | 2 | 17 | 18 | 19 | BluetoothAdvertisements 20 | 21 | 29 | 30 | 31 | -------------------------------------------------------------------------------- /Application/src/main/res/values-v21/base-template-styles.xml: -------------------------------------------------------------------------------- 1 | 2 | 17 | 18 | 19 | 20 | 21 | 26 | 27 | 28 | -------------------------------------------------------------------------------- /Application/src/main/res/values/template-dimens.xml: -------------------------------------------------------------------------------- 1 | 16 | 17 | 18 | 19 | 20 | 21 | 4dp 22 | 8dp 23 | 16dp 24 | 32dp 25 | 64dp 26 | 27 | 28 | 29 | @dimen/margin_medium 30 | @dimen/margin_medium 31 | 32 | 33 | -------------------------------------------------------------------------------- /Application/src/main/java/com/example/android/bluetoothadvertisements/Constants.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2015 The Android Open Source Project 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | package com.example.android.bluetoothadvertisements; 18 | 19 | import android.os.ParcelUuid; 20 | 21 | /** 22 | * Constants for use in the Bluetooth Advertisements sample 23 | */ 24 | public class Constants { 25 | 26 | /** 27 | * UUID identified with this app - set as Service UUID for BLE Advertisements. 28 | * 29 | * Bluetooth requires a certain format for UUIDs associated with Services. 30 | * The official specification can be found here: 31 | * {@link https://www.bluetooth.org/en-us/specification/assigned-numbers/service-discovery} 32 | */ 33 | public static final ParcelUuid Service_UUID = ParcelUuid 34 | .fromString("0000b81d-0000-1000-8000-00805f9b34fb"); 35 | 36 | public static final int REQUEST_ENABLE_BT = 1; 37 | 38 | } 39 | -------------------------------------------------------------------------------- /Application/src/main/res/values/template-styles.xml: -------------------------------------------------------------------------------- 1 | 16 | 17 | 18 | 19 | 20 | 21 | 34 | 35 | 41 | 42 | 43 | -------------------------------------------------------------------------------- /Application/build.gradle: -------------------------------------------------------------------------------- 1 | 2 | buildscript { 3 | repositories { 4 | jcenter() 5 | google() 6 | } 7 | 8 | dependencies { 9 | classpath 'com.android.tools.build:gradle:3.0.1' 10 | } 11 | } 12 | 13 | apply plugin: 'com.android.application' 14 | 15 | repositories { 16 | jcenter() 17 | google() 18 | } 19 | 20 | dependencies { 21 | compile "com.android.support:support-v4:27.0.2" 22 | compile "com.android.support:support-v13:27.0.2" 23 | compile "com.android.support:cardview-v7:27.0.2" 24 | compile "com.android.support:appcompat-v7:27.0.2" 25 | } 26 | 27 | // The sample build uses multiple directories to 28 | // keep boilerplate and common code separate from 29 | // the main sample code. 30 | List dirs = [ 31 | 'main', // main sample code; look here for the interesting stuff. 32 | 'common', // components that are reused by multiple samples 33 | 'template'] // boilerplate code that is generated by the sample template process 34 | 35 | android { 36 | compileSdkVersion 27 37 | 38 | buildToolsVersion "27.0.2" 39 | 40 | defaultConfig { 41 | minSdkVersion 21 42 | targetSdkVersion 27 43 | } 44 | 45 | compileOptions { 46 | sourceCompatibility JavaVersion.VERSION_1_7 47 | targetCompatibility JavaVersion.VERSION_1_7 48 | } 49 | 50 | sourceSets { 51 | main { 52 | dirs.each { dir -> 53 | java.srcDirs "src/${dir}/java" 54 | res.srcDirs "src/${dir}/res" 55 | } 56 | } 57 | androidTest.setRoot('tests') 58 | androidTest.java.srcDirs = ['tests/src'] 59 | 60 | } 61 | 62 | } 63 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # How to become a contributor and submit your own code 2 | 3 | ## Contributor License Agreements 4 | 5 | We'd love to accept your sample apps and patches! Before we can take them, we 6 | have to jump a couple of legal hurdles. 7 | 8 | Please fill out either the individual or corporate Contributor License Agreement (CLA). 9 | 10 | * If you are an individual writing original source code and you're sure you 11 | own the intellectual property, then you'll need to sign an [individual CLA] 12 | (https://cla.developers.google.com). 13 | * If you work for a company that wants to allow you to contribute your work, 14 | then you'll need to sign a [corporate CLA] 15 | (https://cla.developers.google.com). 16 | 17 | Follow either of the two links above to access the appropriate CLA and 18 | instructions for how to sign and return it. Once we receive it, we'll be able to 19 | accept your pull requests. 20 | 21 | ## Contributing A Patch 22 | 23 | 1. Submit an issue describing your proposed change to the repo in question. 24 | 1. The repo owner will respond to your issue promptly. 25 | 1. If your proposed change is accepted, and you haven't already done so, sign a 26 | Contributor License Agreement (see details above). 27 | 1. Fork the desired repo, develop and test your code changes. 28 | 1. Ensure that your code adheres to the existing style in the sample to which 29 | you are contributing. Refer to the 30 | [Android Code Style Guide] 31 | (https://source.android.com/source/code-style.html) for the 32 | recommended coding standards for this organization. 33 | 1. Ensure that your code has an appropriate set of unit tests which all pass. 34 | 1. Submit a pull request. 35 | 36 | -------------------------------------------------------------------------------- /Application/src/main/res/layout/listitem_scanresult.xml: -------------------------------------------------------------------------------- 1 | 2 | 16 | 20 | 21 | 28 | 32 | 33 | 37 | 41 | 42 | -------------------------------------------------------------------------------- /Application/src/main/res/values/strings.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | User declined to enable Bluetooth, exiting Bluetooth Advertisements. 4 | Nearby Devices 5 | Broadcast Device 6 | 7 | Bluetooth is not supported on this device. 8 | Bluetooth Advertisements are not supported on this device. 9 | 10 | Refresh 11 | Start Advertising failed: 12 | already started. 13 | data packet exceeded 31 Byte limit. 14 | not supported on this device. 15 | internal error. 16 | too many advertisers. 17 | Error: Bluetooth object null 18 | Last Seen: 19 | just now 20 | minute ago 21 | hour ago 22 | seconds ago 23 | minutes ago 24 | hours ago 25 | No devices found - refresh to try again. 26 | seconds. 27 | Scanning for 28 | Scanning already started. 29 | (no name) 30 | unknown error 31 | Advertising stopped due to timeout. 32 | 33 | -------------------------------------------------------------------------------- /Application/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 2 | 17 | 21 | 22 | 23 | 24 | 25 | 30 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 41 | 45 | 46 | 47 | 48 | 49 | -------------------------------------------------------------------------------- /Application/src/main/res/layout/fragment_advertiser.xml: -------------------------------------------------------------------------------- 1 | 2 | 16 | 20 | 21 | 22 | 28 | 29 | 36 | 37 | 43 | 44 | 49 | 50 | 51 | 52 | 53 | -------------------------------------------------------------------------------- /Application/src/main/res/layout/activity_main.xml: -------------------------------------------------------------------------------- 1 | 2 | 17 | 23 | 24 | 29 | 30 | 35 | 36 | 37 | 38 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 12 | set DEFAULT_JVM_OPTS= 13 | 14 | set DIRNAME=%~dp0 15 | if "%DIRNAME%" == "" set DIRNAME=. 16 | set APP_BASE_NAME=%~n0 17 | set APP_HOME=%DIRNAME% 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windowz variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | if "%@eval[2+2]" == "4" goto 4NT_args 53 | 54 | :win9xME_args 55 | @rem Slurp the command line arguments. 56 | set CMD_LINE_ARGS= 57 | set _SKIP=2 58 | 59 | :win9xME_args_slurp 60 | if "x%~1" == "x" goto execute 61 | 62 | set CMD_LINE_ARGS=%* 63 | goto execute 64 | 65 | :4NT_args 66 | @rem Get arguments from the 4NT Shell from JP Software 67 | set CMD_LINE_ARGS=%$ 68 | 69 | :execute 70 | @rem Setup the command line 71 | 72 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 73 | 74 | @rem Execute Gradle 75 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 76 | 77 | :end 78 | @rem End local scope for the variables with windows NT shell 79 | if "%ERRORLEVEL%"=="0" goto mainEnd 80 | 81 | :fail 82 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 83 | rem the _cmd.exe /c_ return code! 84 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 85 | exit /b 1 86 | 87 | :mainEnd 88 | if "%OS%"=="Windows_NT" endlocal 89 | 90 | :omega 91 | -------------------------------------------------------------------------------- /Application/src/main/java/com/example/android/bluetoothadvertisements/MainActivity.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2015 The Android Open Source Project 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | package com.example.android.bluetoothadvertisements; 18 | 19 | import android.bluetooth.BluetoothAdapter; 20 | import android.bluetooth.BluetoothManager; 21 | import android.content.Context; 22 | import android.content.Intent; 23 | import android.os.Bundle; 24 | import android.support.v4.app.FragmentActivity; 25 | import android.support.v4.app.FragmentTransaction; 26 | import android.widget.TextView; 27 | import android.widget.Toast; 28 | 29 | /** 30 | * Setup display fragments and ensure the device supports Bluetooth. 31 | */ 32 | public class MainActivity extends FragmentActivity { 33 | 34 | private BluetoothAdapter mBluetoothAdapter; 35 | 36 | @Override 37 | protected void onCreate(Bundle savedInstanceState) { 38 | super.onCreate(savedInstanceState); 39 | setContentView(R.layout.activity_main); 40 | setTitle(R.string.activity_main_title); 41 | 42 | if (savedInstanceState == null) { 43 | 44 | mBluetoothAdapter = ((BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE)) 45 | .getAdapter(); 46 | 47 | // Is Bluetooth supported on this device? 48 | if (mBluetoothAdapter != null) { 49 | 50 | // Is Bluetooth turned on? 51 | if (mBluetoothAdapter.isEnabled()) { 52 | 53 | // Are Bluetooth Advertisements supported on this device? 54 | if (mBluetoothAdapter.isMultipleAdvertisementSupported()) { 55 | 56 | // Everything is supported and enabled, load the fragments. 57 | setupFragments(); 58 | 59 | } else { 60 | 61 | // Bluetooth Advertisements are not supported. 62 | showErrorText(R.string.bt_ads_not_supported); 63 | } 64 | } else { 65 | 66 | // Prompt user to turn on Bluetooth (logic continues in onActivityResult()). 67 | Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE); 68 | startActivityForResult(enableBtIntent, Constants.REQUEST_ENABLE_BT); 69 | } 70 | } else { 71 | 72 | // Bluetooth is not supported. 73 | showErrorText(R.string.bt_not_supported); 74 | } 75 | } 76 | } 77 | 78 | @Override 79 | protected void onActivityResult(int requestCode, int resultCode, Intent data) { 80 | super.onActivityResult(requestCode, resultCode, data); 81 | switch (requestCode) { 82 | case Constants.REQUEST_ENABLE_BT: 83 | 84 | if (resultCode == RESULT_OK) { 85 | 86 | // Bluetooth is now Enabled, are Bluetooth Advertisements supported on 87 | // this device? 88 | if (mBluetoothAdapter.isMultipleAdvertisementSupported()) { 89 | 90 | // Everything is supported and enabled, load the fragments. 91 | setupFragments(); 92 | 93 | } else { 94 | 95 | // Bluetooth Advertisements are not supported. 96 | showErrorText(R.string.bt_ads_not_supported); 97 | } 98 | } else { 99 | 100 | // User declined to enable Bluetooth, exit the app. 101 | Toast.makeText(this, R.string.bt_not_enabled_leaving, 102 | Toast.LENGTH_SHORT).show(); 103 | finish(); 104 | } 105 | 106 | default: 107 | super.onActivityResult(requestCode, resultCode, data); 108 | } 109 | } 110 | 111 | private void setupFragments() { 112 | FragmentTransaction transaction = getSupportFragmentManager().beginTransaction(); 113 | 114 | ScannerFragment scannerFragment = new ScannerFragment(); 115 | // Fragments can't access system services directly, so pass it the BluetoothAdapter 116 | scannerFragment.setBluetoothAdapter(mBluetoothAdapter); 117 | transaction.replace(R.id.scanner_fragment_container, scannerFragment); 118 | 119 | AdvertiserFragment advertiserFragment = new AdvertiserFragment(); 120 | transaction.replace(R.id.advertiser_fragment_container, advertiserFragment); 121 | 122 | transaction.commit(); 123 | } 124 | 125 | private void showErrorText(int messageId) { 126 | 127 | TextView view = (TextView) findViewById(R.id.error_textview); 128 | view.setText(getString(messageId)); 129 | } 130 | } -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env bash 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 10 | DEFAULT_JVM_OPTS="" 11 | 12 | APP_NAME="Gradle" 13 | APP_BASE_NAME=`basename "$0"` 14 | 15 | # Use the maximum available, or set MAX_FD != -1 to use that value. 16 | MAX_FD="maximum" 17 | 18 | warn ( ) { 19 | echo "$*" 20 | } 21 | 22 | die ( ) { 23 | echo 24 | echo "$*" 25 | echo 26 | exit 1 27 | } 28 | 29 | # OS specific support (must be 'true' or 'false'). 30 | cygwin=false 31 | msys=false 32 | darwin=false 33 | case "`uname`" in 34 | CYGWIN* ) 35 | cygwin=true 36 | ;; 37 | Darwin* ) 38 | darwin=true 39 | ;; 40 | MINGW* ) 41 | msys=true 42 | ;; 43 | esac 44 | 45 | # For Cygwin, ensure paths are in UNIX format before anything is touched. 46 | if $cygwin ; then 47 | [ -n "$JAVA_HOME" ] && JAVA_HOME=`cygpath --unix "$JAVA_HOME"` 48 | fi 49 | 50 | # Attempt to set APP_HOME 51 | # Resolve links: $0 may be a link 52 | PRG="$0" 53 | # Need this for relative symlinks. 54 | while [ -h "$PRG" ] ; do 55 | ls=`ls -ld "$PRG"` 56 | link=`expr "$ls" : '.*-> \(.*\)$'` 57 | if expr "$link" : '/.*' > /dev/null; then 58 | PRG="$link" 59 | else 60 | PRG=`dirname "$PRG"`"/$link" 61 | fi 62 | done 63 | SAVED="`pwd`" 64 | cd "`dirname \"$PRG\"`/" >&- 65 | APP_HOME="`pwd -P`" 66 | cd "$SAVED" >&- 67 | 68 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 69 | 70 | # Determine the Java command to use to start the JVM. 71 | if [ -n "$JAVA_HOME" ] ; then 72 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 73 | # IBM's JDK on AIX uses strange locations for the executables 74 | JAVACMD="$JAVA_HOME/jre/sh/java" 75 | else 76 | JAVACMD="$JAVA_HOME/bin/java" 77 | fi 78 | if [ ! -x "$JAVACMD" ] ; then 79 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 80 | 81 | Please set the JAVA_HOME variable in your environment to match the 82 | location of your Java installation." 83 | fi 84 | else 85 | JAVACMD="java" 86 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 87 | 88 | Please set the JAVA_HOME variable in your environment to match the 89 | location of your Java installation." 90 | fi 91 | 92 | # Increase the maximum file descriptors if we can. 93 | if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then 94 | MAX_FD_LIMIT=`ulimit -H -n` 95 | if [ $? -eq 0 ] ; then 96 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 97 | MAX_FD="$MAX_FD_LIMIT" 98 | fi 99 | ulimit -n $MAX_FD 100 | if [ $? -ne 0 ] ; then 101 | warn "Could not set maximum file descriptor limit: $MAX_FD" 102 | fi 103 | else 104 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 105 | fi 106 | fi 107 | 108 | # For Darwin, add options to specify how the application appears in the dock 109 | if $darwin; then 110 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 111 | fi 112 | 113 | # For Cygwin, switch paths to Windows format before running java 114 | if $cygwin ; then 115 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 116 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules 158 | function splitJvmOpts() { 159 | JVM_OPTS=("$@") 160 | } 161 | eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS 162 | JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME" 163 | 164 | exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@" 165 | -------------------------------------------------------------------------------- /Application/src/main/java/com/example/android/bluetoothadvertisements/ScanResultAdapter.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2015 The Android Open Source Project 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | package com.example.android.bluetoothadvertisements; 18 | 19 | import android.bluetooth.le.ScanResult; 20 | import android.content.Context; 21 | import android.os.SystemClock; 22 | import android.view.LayoutInflater; 23 | import android.view.View; 24 | import android.view.ViewGroup; 25 | import android.widget.BaseAdapter; 26 | import android.widget.TextView; 27 | 28 | import java.util.ArrayList; 29 | import java.util.concurrent.TimeUnit; 30 | 31 | /** 32 | * Holds and displays {@link ScanResult}s, used by {@link ScannerFragment}. 33 | */ 34 | public class ScanResultAdapter extends BaseAdapter { 35 | 36 | private ArrayList mArrayList; 37 | 38 | private Context mContext; 39 | 40 | private LayoutInflater mInflater; 41 | 42 | ScanResultAdapter(Context context, LayoutInflater inflater) { 43 | super(); 44 | mContext = context; 45 | mInflater = inflater; 46 | mArrayList = new ArrayList<>(); 47 | } 48 | 49 | @Override 50 | public int getCount() { 51 | return mArrayList.size(); 52 | } 53 | 54 | @Override 55 | public Object getItem(int position) { 56 | return mArrayList.get(position); 57 | } 58 | 59 | @Override 60 | public long getItemId(int position) { 61 | return mArrayList.get(position).getDevice().getAddress().hashCode(); 62 | } 63 | 64 | @Override 65 | public View getView(int position, View view, ViewGroup parent) { 66 | 67 | // Reuse an old view if we can, otherwise create a new one. 68 | if (view == null) { 69 | view = mInflater.inflate(R.layout.listitem_scanresult, null); 70 | } 71 | 72 | TextView deviceNameView = (TextView) view.findViewById(R.id.device_name); 73 | TextView deviceAddressView = (TextView) view.findViewById(R.id.device_address); 74 | TextView lastSeenView = (TextView) view.findViewById(R.id.last_seen); 75 | 76 | ScanResult scanResult = mArrayList.get(position); 77 | 78 | String name = scanResult.getDevice().getName(); 79 | if (name == null) { 80 | name = mContext.getResources().getString(R.string.no_name); 81 | } 82 | deviceNameView.setText(name); 83 | deviceAddressView.setText(scanResult.getDevice().getAddress()); 84 | lastSeenView.setText(getTimeSinceString(mContext, scanResult.getTimestampNanos())); 85 | 86 | return view; 87 | } 88 | 89 | /** 90 | * Search the adapter for an existing device address and return it, otherwise return -1. 91 | */ 92 | private int getPosition(String address) { 93 | int position = -1; 94 | for (int i = 0; i < mArrayList.size(); i++) { 95 | if (mArrayList.get(i).getDevice().getAddress().equals(address)) { 96 | position = i; 97 | break; 98 | } 99 | } 100 | return position; 101 | } 102 | 103 | 104 | /** 105 | * Add a ScanResult item to the adapter if a result from that device isn't already present. 106 | * Otherwise updates the existing position with the new ScanResult. 107 | */ 108 | public void add(ScanResult scanResult) { 109 | 110 | int existingPosition = getPosition(scanResult.getDevice().getAddress()); 111 | 112 | if (existingPosition >= 0) { 113 | // Device is already in list, update its record. 114 | mArrayList.set(existingPosition, scanResult); 115 | } else { 116 | // Add new Device's ScanResult to list. 117 | mArrayList.add(scanResult); 118 | } 119 | } 120 | 121 | /** 122 | * Clear out the adapter. 123 | */ 124 | public void clear() { 125 | mArrayList.clear(); 126 | } 127 | 128 | /** 129 | * Takes in a number of nanoseconds and returns a human-readable string giving a vague 130 | * description of how long ago that was. 131 | */ 132 | public static String getTimeSinceString(Context context, long timeNanoseconds) { 133 | String lastSeenText = context.getResources().getString(R.string.last_seen) + " "; 134 | 135 | long timeSince = SystemClock.elapsedRealtimeNanos() - timeNanoseconds; 136 | long secondsSince = TimeUnit.SECONDS.convert(timeSince, TimeUnit.NANOSECONDS); 137 | 138 | if (secondsSince < 5) { 139 | lastSeenText += context.getResources().getString(R.string.just_now); 140 | } else if (secondsSince < 60) { 141 | lastSeenText += secondsSince + " " + context.getResources() 142 | .getString(R.string.seconds_ago); 143 | } else { 144 | long minutesSince = TimeUnit.MINUTES.convert(secondsSince, TimeUnit.SECONDS); 145 | if (minutesSince < 60) { 146 | if (minutesSince == 1) { 147 | lastSeenText += minutesSince + " " + context.getResources() 148 | .getString(R.string.minute_ago); 149 | } else { 150 | lastSeenText += minutesSince + " " + context.getResources() 151 | .getString(R.string.minutes_ago); 152 | } 153 | } else { 154 | long hoursSince = TimeUnit.HOURS.convert(minutesSince, TimeUnit.MINUTES); 155 | if (hoursSince == 1) { 156 | lastSeenText += hoursSince + " " + context.getResources() 157 | .getString(R.string.hour_ago); 158 | } else { 159 | lastSeenText += hoursSince + " " + context.getResources() 160 | .getString(R.string.hours_ago); 161 | } 162 | } 163 | } 164 | 165 | return lastSeenText; 166 | } 167 | } 168 | -------------------------------------------------------------------------------- /Application/src/main/java/com/example/android/bluetoothadvertisements/AdvertiserFragment.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2015 The Android Open Source Project 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | package com.example.android.bluetoothadvertisements; 18 | 19 | import android.bluetooth.le.AdvertiseCallback; 20 | import android.content.BroadcastReceiver; 21 | import android.content.Context; 22 | import android.content.Intent; 23 | import android.content.IntentFilter; 24 | import android.os.Bundle; 25 | import android.support.v4.app.Fragment; 26 | import android.view.LayoutInflater; 27 | import android.view.View; 28 | import android.view.ViewGroup; 29 | import android.widget.Switch; 30 | import android.widget.Toast; 31 | 32 | /** 33 | * Allows user to start & stop Bluetooth LE Advertising of their device. 34 | */ 35 | public class AdvertiserFragment extends Fragment implements View.OnClickListener { 36 | 37 | /** 38 | * Lets user toggle BLE Advertising. 39 | */ 40 | private Switch mSwitch; 41 | 42 | /** 43 | * Listens for notifications that the {@code AdvertiserService} has failed to start advertising. 44 | * This Receiver deals with Fragment UI elements and only needs to be active when the Fragment 45 | * is on-screen, so it's defined and registered in code instead of the Manifest. 46 | */ 47 | private BroadcastReceiver advertisingFailureReceiver; 48 | 49 | @Override 50 | public void onCreate(Bundle savedInstanceState) { 51 | super.onCreate(savedInstanceState); 52 | 53 | advertisingFailureReceiver = new BroadcastReceiver() { 54 | 55 | /** 56 | * Receives Advertising error codes from {@code AdvertiserService} and displays error messages 57 | * to the user. Sets the advertising toggle to 'false.' 58 | */ 59 | @Override 60 | public void onReceive(Context context, Intent intent) { 61 | 62 | int errorCode = intent.getIntExtra(AdvertiserService.ADVERTISING_FAILED_EXTRA_CODE, -1); 63 | 64 | mSwitch.setChecked(false); 65 | 66 | String errorMessage = getString(R.string.start_error_prefix); 67 | switch (errorCode) { 68 | case AdvertiseCallback.ADVERTISE_FAILED_ALREADY_STARTED: 69 | errorMessage += " " + getString(R.string.start_error_already_started); 70 | break; 71 | case AdvertiseCallback.ADVERTISE_FAILED_DATA_TOO_LARGE: 72 | errorMessage += " " + getString(R.string.start_error_too_large); 73 | break; 74 | case AdvertiseCallback.ADVERTISE_FAILED_FEATURE_UNSUPPORTED: 75 | errorMessage += " " + getString(R.string.start_error_unsupported); 76 | break; 77 | case AdvertiseCallback.ADVERTISE_FAILED_INTERNAL_ERROR: 78 | errorMessage += " " + getString(R.string.start_error_internal); 79 | break; 80 | case AdvertiseCallback.ADVERTISE_FAILED_TOO_MANY_ADVERTISERS: 81 | errorMessage += " " + getString(R.string.start_error_too_many); 82 | break; 83 | case AdvertiserService.ADVERTISING_TIMED_OUT: 84 | errorMessage = " " + getString(R.string.advertising_timedout); 85 | break; 86 | default: 87 | errorMessage += " " + getString(R.string.start_error_unknown); 88 | } 89 | 90 | Toast.makeText(getActivity(), errorMessage, Toast.LENGTH_LONG).show(); 91 | } 92 | }; 93 | } 94 | 95 | @Override 96 | public View onCreateView(LayoutInflater inflater, ViewGroup container, 97 | Bundle savedInstanceState) { 98 | 99 | View view = inflater.inflate(R.layout.fragment_advertiser, container, false); 100 | 101 | mSwitch = (Switch) view.findViewById(R.id.advertise_switch); 102 | mSwitch.setOnClickListener(this); 103 | 104 | return view; 105 | } 106 | 107 | /** 108 | * When app comes on screen, check if BLE Advertisements are running, set switch accordingly, 109 | * and register the Receiver to be notified if Advertising fails. 110 | */ 111 | @Override 112 | public void onResume() { 113 | super.onResume(); 114 | 115 | if (AdvertiserService.running) { 116 | mSwitch.setChecked(true); 117 | } else { 118 | mSwitch.setChecked(false); 119 | } 120 | 121 | IntentFilter failureFilter = new IntentFilter(AdvertiserService.ADVERTISING_FAILED); 122 | getActivity().registerReceiver(advertisingFailureReceiver, failureFilter); 123 | 124 | } 125 | 126 | /** 127 | * When app goes off screen, unregister the Advertising failure Receiver to stop memory leaks. 128 | * (and because the app doesn't care if Advertising fails while the UI isn't active) 129 | */ 130 | @Override 131 | public void onPause() { 132 | super.onPause(); 133 | getActivity().unregisterReceiver(advertisingFailureReceiver); 134 | } 135 | 136 | /** 137 | * Returns Intent addressed to the {@code AdvertiserService} class. 138 | */ 139 | private static Intent getServiceIntent(Context c) { 140 | return new Intent(c, AdvertiserService.class); 141 | } 142 | 143 | /** 144 | * Called when switch is toggled - starts or stops advertising. 145 | */ 146 | @Override 147 | public void onClick(View v) { 148 | // Is the toggle on? 149 | boolean on = ((Switch) v).isChecked(); 150 | 151 | if (on) { 152 | startAdvertising(); 153 | } else { 154 | stopAdvertising(); 155 | } 156 | } 157 | 158 | /** 159 | * Starts BLE Advertising by starting {@code AdvertiserService}. 160 | */ 161 | private void startAdvertising() { 162 | Context c = getActivity(); 163 | c.startService(getServiceIntent(c)); 164 | } 165 | 166 | /** 167 | * Stops BLE Advertising by stopping {@code AdvertiserService}. 168 | */ 169 | private void stopAdvertising() { 170 | Context c = getActivity(); 171 | c.stopService(getServiceIntent(c)); 172 | mSwitch.setChecked(false); 173 | } 174 | 175 | } -------------------------------------------------------------------------------- /Application/src/main/java/com/example/android/bluetoothadvertisements/ScannerFragment.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2015 The Android Open Source Project 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | package com.example.android.bluetoothadvertisements; 18 | 19 | import android.bluetooth.BluetoothAdapter; 20 | import android.bluetooth.le.BluetoothLeScanner; 21 | import android.bluetooth.le.ScanCallback; 22 | import android.bluetooth.le.ScanFilter; 23 | import android.bluetooth.le.ScanResult; 24 | import android.bluetooth.le.ScanSettings; 25 | import android.os.Bundle; 26 | import android.os.Handler; 27 | import android.support.v4.app.ListFragment; 28 | import android.util.Log; 29 | import android.view.LayoutInflater; 30 | import android.view.Menu; 31 | import android.view.MenuInflater; 32 | import android.view.MenuItem; 33 | import android.view.View; 34 | import android.view.ViewGroup; 35 | import android.widget.Toast; 36 | 37 | import java.util.ArrayList; 38 | import java.util.List; 39 | import java.util.concurrent.TimeUnit; 40 | 41 | 42 | /** 43 | * Scans for Bluetooth Low Energy Advertisements matching a filter and displays them to the user. 44 | */ 45 | public class ScannerFragment extends ListFragment { 46 | 47 | private static final String TAG = ScannerFragment.class.getSimpleName(); 48 | 49 | /** 50 | * Stops scanning after 5 seconds. 51 | */ 52 | private static final long SCAN_PERIOD = 5000; 53 | 54 | private BluetoothAdapter mBluetoothAdapter; 55 | 56 | private BluetoothLeScanner mBluetoothLeScanner; 57 | 58 | private ScanCallback mScanCallback; 59 | 60 | private ScanResultAdapter mAdapter; 61 | 62 | private Handler mHandler; 63 | 64 | /** 65 | * Must be called after object creation by MainActivity. 66 | * 67 | * @param btAdapter the local BluetoothAdapter 68 | */ 69 | public void setBluetoothAdapter(BluetoothAdapter btAdapter) { 70 | this.mBluetoothAdapter = btAdapter; 71 | mBluetoothLeScanner = mBluetoothAdapter.getBluetoothLeScanner(); 72 | } 73 | 74 | @Override 75 | public void onCreate(Bundle savedInstanceState) { 76 | super.onCreate(savedInstanceState); 77 | setHasOptionsMenu(true); 78 | setRetainInstance(true); 79 | 80 | // Use getActivity().getApplicationContext() instead of just getActivity() because this 81 | // object lives in a fragment and needs to be kept separate from the Activity lifecycle. 82 | // 83 | // We could get a LayoutInflater from the ApplicationContext but it messes with the 84 | // default theme, so generate it from getActivity() and pass it in separately. 85 | mAdapter = new ScanResultAdapter(getActivity().getApplicationContext(), 86 | LayoutInflater.from(getActivity())); 87 | mHandler = new Handler(); 88 | 89 | } 90 | 91 | @Override 92 | public View onCreateView(LayoutInflater inflater, ViewGroup container, 93 | Bundle savedInstanceState) { 94 | 95 | final View view = super.onCreateView(inflater, container, savedInstanceState); 96 | 97 | setListAdapter(mAdapter); 98 | 99 | return view; 100 | } 101 | 102 | @Override 103 | public void onViewCreated(View view, Bundle savedInstanceState) { 104 | super.onViewCreated(view, savedInstanceState); 105 | 106 | getListView().setDivider(null); 107 | getListView().setDividerHeight(0); 108 | 109 | setEmptyText(getString(R.string.empty_list)); 110 | 111 | // Trigger refresh on app's 1st load 112 | startScanning(); 113 | 114 | } 115 | 116 | @Override 117 | public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { 118 | super.onCreateOptionsMenu(menu, inflater); 119 | inflater.inflate(R.menu.scanner_menu, menu); 120 | } 121 | 122 | @Override 123 | public boolean onOptionsItemSelected(MenuItem item) { 124 | 125 | switch (item.getItemId()) { 126 | case R.id.refresh: 127 | startScanning(); 128 | return true; 129 | default: 130 | return super.onOptionsItemSelected(item); 131 | } 132 | } 133 | 134 | /** 135 | * Start scanning for BLE Advertisements (& set it up to stop after a set period of time). 136 | */ 137 | public void startScanning() { 138 | if (mScanCallback == null) { 139 | Log.d(TAG, "Starting Scanning"); 140 | 141 | // Will stop the scanning after a set time. 142 | mHandler.postDelayed(new Runnable() { 143 | @Override 144 | public void run() { 145 | stopScanning(); 146 | } 147 | }, SCAN_PERIOD); 148 | 149 | // Kick off a new scan. 150 | mScanCallback = new SampleScanCallback(); 151 | mBluetoothLeScanner.startScan(buildScanFilters(), buildScanSettings(), mScanCallback); 152 | 153 | String toastText = getString(R.string.scan_start_toast) + " " 154 | + TimeUnit.SECONDS.convert(SCAN_PERIOD, TimeUnit.MILLISECONDS) + " " 155 | + getString(R.string.seconds); 156 | Toast.makeText(getActivity(), toastText, Toast.LENGTH_LONG).show(); 157 | } else { 158 | Toast.makeText(getActivity(), R.string.already_scanning, Toast.LENGTH_SHORT); 159 | } 160 | } 161 | 162 | /** 163 | * Stop scanning for BLE Advertisements. 164 | */ 165 | public void stopScanning() { 166 | Log.d(TAG, "Stopping Scanning"); 167 | 168 | // Stop the scan, wipe the callback. 169 | mBluetoothLeScanner.stopScan(mScanCallback); 170 | mScanCallback = null; 171 | 172 | // Even if no new results, update 'last seen' times. 173 | mAdapter.notifyDataSetChanged(); 174 | } 175 | 176 | /** 177 | * Return a List of {@link ScanFilter} objects to filter by Service UUID. 178 | */ 179 | private List buildScanFilters() { 180 | List scanFilters = new ArrayList<>(); 181 | 182 | ScanFilter.Builder builder = new ScanFilter.Builder(); 183 | // Comment out the below line to see all BLE devices around you 184 | builder.setServiceUuid(Constants.Service_UUID); 185 | scanFilters.add(builder.build()); 186 | 187 | return scanFilters; 188 | } 189 | 190 | /** 191 | * Return a {@link ScanSettings} object set to use low power (to preserve battery life). 192 | */ 193 | private ScanSettings buildScanSettings() { 194 | ScanSettings.Builder builder = new ScanSettings.Builder(); 195 | builder.setScanMode(ScanSettings.SCAN_MODE_LOW_POWER); 196 | return builder.build(); 197 | } 198 | 199 | /** 200 | * Custom ScanCallback object - adds to adapter on success, displays error on failure. 201 | */ 202 | private class SampleScanCallback extends ScanCallback { 203 | 204 | @Override 205 | public void onBatchScanResults(List results) { 206 | super.onBatchScanResults(results); 207 | 208 | for (ScanResult result : results) { 209 | mAdapter.add(result); 210 | } 211 | mAdapter.notifyDataSetChanged(); 212 | } 213 | 214 | @Override 215 | public void onScanResult(int callbackType, ScanResult result) { 216 | super.onScanResult(callbackType, result); 217 | 218 | mAdapter.add(result); 219 | mAdapter.notifyDataSetChanged(); 220 | } 221 | 222 | @Override 223 | public void onScanFailed(int errorCode) { 224 | super.onScanFailed(errorCode); 225 | Toast.makeText(getActivity(), "Scan failed with error: " + errorCode, Toast.LENGTH_LONG) 226 | .show(); 227 | } 228 | } 229 | } 230 | -------------------------------------------------------------------------------- /Application/src/main/java/com/example/android/bluetoothadvertisements/AdvertiserService.java: -------------------------------------------------------------------------------- 1 | package com.example.android.bluetoothadvertisements; 2 | 3 | import android.app.Notification; 4 | import android.app.PendingIntent; 5 | import android.app.Service; 6 | import android.bluetooth.BluetoothAdapter; 7 | import android.bluetooth.BluetoothManager; 8 | import android.bluetooth.le.AdvertiseCallback; 9 | import android.bluetooth.le.AdvertiseData; 10 | import android.bluetooth.le.AdvertiseSettings; 11 | import android.bluetooth.le.BluetoothLeAdvertiser; 12 | import android.content.Context; 13 | import android.content.Intent; 14 | import android.os.Handler; 15 | import android.os.IBinder; 16 | import android.util.Log; 17 | import android.widget.Toast; 18 | 19 | import java.util.concurrent.TimeUnit; 20 | 21 | /** 22 | * Manages BLE Advertising independent of the main app. 23 | * If the app goes off screen (or gets killed completely) advertising can continue because this 24 | * Service is maintaining the necessary Callback in memory. 25 | */ 26 | public class AdvertiserService extends Service { 27 | 28 | private static final String TAG = AdvertiserService.class.getSimpleName(); 29 | 30 | private static final int FOREGROUND_NOTIFICATION_ID = 1; 31 | 32 | /** 33 | * A global variable to let AdvertiserFragment check if the Service is running without needing 34 | * to start or bind to it. 35 | * This is the best practice method as defined here: 36 | * https://groups.google.com/forum/#!topic/android-developers/jEvXMWgbgzE 37 | */ 38 | public static boolean running = false; 39 | 40 | public static final String ADVERTISING_FAILED = 41 | "com.example.android.bluetoothadvertisements.advertising_failed"; 42 | 43 | public static final String ADVERTISING_FAILED_EXTRA_CODE = "failureCode"; 44 | 45 | public static final int ADVERTISING_TIMED_OUT = 6; 46 | 47 | private BluetoothLeAdvertiser mBluetoothLeAdvertiser; 48 | 49 | private AdvertiseCallback mAdvertiseCallback; 50 | 51 | private Handler mHandler; 52 | 53 | private Runnable timeoutRunnable; 54 | 55 | /** 56 | * Length of time to allow advertising before automatically shutting off. (10 minutes) 57 | */ 58 | private long TIMEOUT = TimeUnit.MILLISECONDS.convert(10, TimeUnit.MINUTES); 59 | 60 | @Override 61 | public void onCreate() { 62 | running = true; 63 | initialize(); 64 | startAdvertising(); 65 | setTimeout(); 66 | super.onCreate(); 67 | } 68 | 69 | @Override 70 | public void onDestroy() { 71 | /** 72 | * Note that onDestroy is not guaranteed to be called quickly or at all. Services exist at 73 | * the whim of the system, and onDestroy can be delayed or skipped entirely if memory need 74 | * is critical. 75 | */ 76 | running = false; 77 | stopAdvertising(); 78 | mHandler.removeCallbacks(timeoutRunnable); 79 | stopForeground(true); 80 | super.onDestroy(); 81 | } 82 | 83 | /** 84 | * Required for extending service, but this will be a Started Service only, so no need for 85 | * binding. 86 | */ 87 | @Override 88 | public IBinder onBind(Intent intent) { 89 | return null; 90 | } 91 | 92 | /** 93 | * Get references to system Bluetooth objects if we don't have them already. 94 | */ 95 | private void initialize() { 96 | if (mBluetoothLeAdvertiser == null) { 97 | BluetoothManager mBluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); 98 | if (mBluetoothManager != null) { 99 | BluetoothAdapter mBluetoothAdapter = mBluetoothManager.getAdapter(); 100 | if (mBluetoothAdapter != null) { 101 | mBluetoothLeAdvertiser = mBluetoothAdapter.getBluetoothLeAdvertiser(); 102 | } else { 103 | Toast.makeText(this, getString(R.string.bt_null), Toast.LENGTH_LONG).show(); 104 | } 105 | } else { 106 | Toast.makeText(this, getString(R.string.bt_null), Toast.LENGTH_LONG).show(); 107 | } 108 | } 109 | 110 | } 111 | 112 | /** 113 | * Starts a delayed Runnable that will cause the BLE Advertising to timeout and stop after a 114 | * set amount of time. 115 | */ 116 | private void setTimeout(){ 117 | mHandler = new Handler(); 118 | timeoutRunnable = new Runnable() { 119 | @Override 120 | public void run() { 121 | Log.d(TAG, "AdvertiserService has reached timeout of "+TIMEOUT+" milliseconds, stopping advertising."); 122 | sendFailureIntent(ADVERTISING_TIMED_OUT); 123 | stopSelf(); 124 | } 125 | }; 126 | mHandler.postDelayed(timeoutRunnable, TIMEOUT); 127 | } 128 | 129 | /** 130 | * Starts BLE Advertising. 131 | */ 132 | private void startAdvertising() { 133 | goForeground(); 134 | 135 | Log.d(TAG, "Service: Starting Advertising"); 136 | 137 | if (mAdvertiseCallback == null) { 138 | AdvertiseSettings settings = buildAdvertiseSettings(); 139 | AdvertiseData data = buildAdvertiseData(); 140 | mAdvertiseCallback = new SampleAdvertiseCallback(); 141 | 142 | if (mBluetoothLeAdvertiser != null) { 143 | mBluetoothLeAdvertiser.startAdvertising(settings, data, 144 | mAdvertiseCallback); 145 | } 146 | } 147 | } 148 | 149 | /** 150 | * Move service to the foreground, to avoid execution limits on background processes. 151 | * 152 | * Callers should call stopForeground(true) when background work is complete. 153 | */ 154 | private void goForeground() { 155 | Intent notificationIntent = new Intent(this, MainActivity.class); 156 | PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, 157 | notificationIntent, 0); 158 | Notification n = new Notification.Builder(this) 159 | .setContentTitle("Advertising device via Bluetooth") 160 | .setContentText("This device is discoverable to others nearby.") 161 | .setSmallIcon(R.drawable.ic_launcher) 162 | .setContentIntent(pendingIntent) 163 | .build(); 164 | startForeground(FOREGROUND_NOTIFICATION_ID, n); 165 | } 166 | 167 | /** 168 | * Stops BLE Advertising. 169 | */ 170 | private void stopAdvertising() { 171 | Log.d(TAG, "Service: Stopping Advertising"); 172 | if (mBluetoothLeAdvertiser != null) { 173 | mBluetoothLeAdvertiser.stopAdvertising(mAdvertiseCallback); 174 | mAdvertiseCallback = null; 175 | } 176 | } 177 | 178 | /** 179 | * Returns an AdvertiseData object which includes the Service UUID and Device Name. 180 | */ 181 | private AdvertiseData buildAdvertiseData() { 182 | 183 | /** 184 | * Note: There is a strict limit of 31 Bytes on packets sent over BLE Advertisements. 185 | * This includes everything put into AdvertiseData including UUIDs, device info, & 186 | * arbitrary service or manufacturer data. 187 | * Attempting to send packets over this limit will result in a failure with error code 188 | * AdvertiseCallback.ADVERTISE_FAILED_DATA_TOO_LARGE. Catch this error in the 189 | * onStartFailure() method of an AdvertiseCallback implementation. 190 | */ 191 | 192 | AdvertiseData.Builder dataBuilder = new AdvertiseData.Builder(); 193 | dataBuilder.addServiceUuid(Constants.Service_UUID); 194 | dataBuilder.setIncludeDeviceName(true); 195 | 196 | /* For example - this will cause advertising to fail (exceeds size limit) */ 197 | //String failureData = "asdghkajsghalkxcjhfa;sghtalksjcfhalskfjhasldkjfhdskf"; 198 | //dataBuilder.addServiceData(Constants.Service_UUID, failureData.getBytes()); 199 | 200 | return dataBuilder.build(); 201 | } 202 | 203 | /** 204 | * Returns an AdvertiseSettings object set to use low power (to help preserve battery life) 205 | * and disable the built-in timeout since this code uses its own timeout runnable. 206 | */ 207 | private AdvertiseSettings buildAdvertiseSettings() { 208 | AdvertiseSettings.Builder settingsBuilder = new AdvertiseSettings.Builder(); 209 | settingsBuilder.setAdvertiseMode(AdvertiseSettings.ADVERTISE_MODE_LOW_POWER); 210 | settingsBuilder.setTimeout(0); 211 | return settingsBuilder.build(); 212 | } 213 | 214 | /** 215 | * Custom callback after Advertising succeeds or fails to start. Broadcasts the error code 216 | * in an Intent to be picked up by AdvertiserFragment and stops this Service. 217 | */ 218 | private class SampleAdvertiseCallback extends AdvertiseCallback { 219 | 220 | @Override 221 | public void onStartFailure(int errorCode) { 222 | super.onStartFailure(errorCode); 223 | 224 | Log.d(TAG, "Advertising failed"); 225 | sendFailureIntent(errorCode); 226 | stopSelf(); 227 | 228 | } 229 | 230 | @Override 231 | public void onStartSuccess(AdvertiseSettings settingsInEffect) { 232 | super.onStartSuccess(settingsInEffect); 233 | Log.d(TAG, "Advertising successfully started"); 234 | } 235 | } 236 | 237 | /** 238 | * Builds and sends a broadcast intent indicating Advertising has failed. Includes the error 239 | * code as an extra. This is intended to be picked up by the {@code AdvertiserFragment}. 240 | */ 241 | private void sendFailureIntent(int errorCode){ 242 | Intent failureIntent = new Intent(); 243 | failureIntent.setAction(ADVERTISING_FAILED); 244 | failureIntent.putExtra(ADVERTISING_FAILED_EXTRA_CODE, errorCode); 245 | sendBroadcast(failureIntent); 246 | } 247 | 248 | } 249 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | -------------- 3 | 4 | Version 2.0, January 2004 5 | http://www.apache.org/licenses/ 6 | 7 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 8 | 9 | 1. Definitions. 10 | 11 | "License" shall mean the terms and conditions for use, reproduction, 12 | and distribution as defined by Sections 1 through 9 of this document. 13 | 14 | "Licensor" shall mean the copyright owner or entity authorized by 15 | the copyright owner that is granting the License. 16 | 17 | "Legal Entity" shall mean the union of the acting entity and all 18 | other entities that control, are controlled by, or are under common 19 | control with that entity. For the purposes of this definition, 20 | "control" means (i) the power, direct or indirect, to cause the 21 | direction or management of such entity, whether by contract or 22 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 23 | outstanding shares, or (iii) beneficial ownership of such entity. 24 | 25 | "You" (or "Your") shall mean an individual or Legal Entity 26 | exercising permissions granted by this License. 27 | 28 | "Source" form shall mean the preferred form for making modifications, 29 | including but not limited to software source code, documentation 30 | source, and configuration files. 31 | 32 | "Object" form shall mean any form resulting from mechanical 33 | transformation or translation of a Source form, including but 34 | not limited to compiled object code, generated documentation, 35 | and conversions to other media types. 36 | 37 | "Work" shall mean the work of authorship, whether in Source or 38 | Object form, made available under the License, as indicated by a 39 | copyright notice that is included in or attached to the work 40 | (an example is provided in the Appendix below). 41 | 42 | "Derivative Works" shall mean any work, whether in Source or Object 43 | form, that is based on (or derived from) the Work and for which the 44 | editorial revisions, annotations, elaborations, or other modifications 45 | represent, as a whole, an original work of authorship. For the purposes 46 | of this License, Derivative Works shall not include works that remain 47 | separable from, or merely link (or bind by name) to the interfaces of, 48 | the Work and Derivative Works thereof. 49 | 50 | "Contribution" shall mean any work of authorship, including 51 | the original version of the Work and any modifications or additions 52 | to that Work or Derivative Works thereof, that is intentionally 53 | submitted to Licensor for inclusion in the Work by the copyright owner 54 | or by an individual or Legal Entity authorized to submit on behalf of 55 | the copyright owner. For the purposes of this definition, "submitted" 56 | means any form of electronic, verbal, or written communication sent 57 | to the Licensor or its representatives, including but not limited to 58 | communication on electronic mailing lists, source code control systems, 59 | and issue tracking systems that are managed by, or on behalf of, the 60 | Licensor for the purpose of discussing and improving the Work, but 61 | excluding communication that is conspicuously marked or otherwise 62 | designated in writing by the copyright owner as "Not a Contribution." 63 | 64 | "Contributor" shall mean Licensor and any individual or Legal Entity 65 | on behalf of whom a Contribution has been received by Licensor and 66 | subsequently incorporated within the Work. 67 | 68 | 2. Grant of Copyright License. Subject to the terms and conditions of 69 | this License, each Contributor hereby grants to You a perpetual, 70 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 71 | copyright license to reproduce, prepare Derivative Works of, 72 | publicly display, publicly perform, sublicense, and distribute the 73 | Work and such Derivative Works in Source or Object form. 74 | 75 | 3. Grant of Patent License. Subject to the terms and conditions of 76 | this License, each Contributor hereby grants to You a perpetual, 77 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 78 | (except as stated in this section) patent license to make, have made, 79 | use, offer to sell, sell, import, and otherwise transfer the Work, 80 | where such license applies only to those patent claims licensable 81 | by such Contributor that are necessarily infringed by their 82 | Contribution(s) alone or by combination of their Contribution(s) 83 | with the Work to which such Contribution(s) was submitted. If You 84 | institute patent litigation against any entity (including a 85 | cross-claim or counterclaim in a lawsuit) alleging that the Work 86 | or a Contribution incorporated within the Work constitutes direct 87 | or contributory patent infringement, then any patent licenses 88 | granted to You under this License for that Work shall terminate 89 | as of the date such litigation is filed. 90 | 91 | 4. Redistribution. You may reproduce and distribute copies of the 92 | Work or Derivative Works thereof in any medium, with or without 93 | modifications, and in Source or Object form, provided that You 94 | meet the following conditions: 95 | 96 | (a) You must give any other recipients of the Work or 97 | Derivative Works a copy of this License; and 98 | 99 | (b) You must cause any modified files to carry prominent notices 100 | stating that You changed the files; and 101 | 102 | (c) You must retain, in the Source form of any Derivative Works 103 | that You distribute, all copyright, patent, trademark, and 104 | attribution notices from the Source form of the Work, 105 | excluding those notices that do not pertain to any part of 106 | the Derivative Works; and 107 | 108 | (d) If the Work includes a "NOTICE" text file as part of its 109 | distribution, then any Derivative Works that You distribute must 110 | include a readable copy of the attribution notices contained 111 | within such NOTICE file, excluding those notices that do not 112 | pertain to any part of the Derivative Works, in at least one 113 | of the following places: within a NOTICE text file distributed 114 | as part of the Derivative Works; within the Source form or 115 | documentation, if provided along with the Derivative Works; or, 116 | within a display generated by the Derivative Works, if and 117 | wherever such third-party notices normally appear. The contents 118 | of the NOTICE file are for informational purposes only and 119 | do not modify the License. You may add Your own attribution 120 | notices within Derivative Works that You distribute, alongside 121 | or as an addendum to the NOTICE text from the Work, provided 122 | that such additional attribution notices cannot be construed 123 | as modifying the License. 124 | 125 | You may add Your own copyright statement to Your modifications and 126 | may provide additional or different license terms and conditions 127 | for use, reproduction, or distribution of Your modifications, or 128 | for any such Derivative Works as a whole, provided Your use, 129 | reproduction, and distribution of the Work otherwise complies with 130 | the conditions stated in this License. 131 | 132 | 5. Submission of Contributions. Unless You explicitly state otherwise, 133 | any Contribution intentionally submitted for inclusion in the Work 134 | by You to the Licensor shall be under the terms and conditions of 135 | this License, without any additional terms or conditions. 136 | Notwithstanding the above, nothing herein shall supersede or modify 137 | the terms of any separate license agreement you may have executed 138 | with Licensor regarding such Contributions. 139 | 140 | 6. Trademarks. This License does not grant permission to use the trade 141 | names, trademarks, service marks, or product names of the Licensor, 142 | except as required for reasonable and customary use in describing the 143 | origin of the Work and reproducing the content of the NOTICE file. 144 | 145 | 7. Disclaimer of Warranty. Unless required by applicable law or 146 | agreed to in writing, Licensor provides the Work (and each 147 | Contributor provides its Contributions) on an "AS IS" BASIS, 148 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 149 | implied, including, without limitation, any warranties or conditions 150 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 151 | PARTICULAR PURPOSE. You are solely responsible for determining the 152 | appropriateness of using or redistributing the Work and assume any 153 | risks associated with Your exercise of permissions under this License. 154 | 155 | 8. Limitation of Liability. In no event and under no legal theory, 156 | whether in tort (including negligence), contract, or otherwise, 157 | unless required by applicable law (such as deliberate and grossly 158 | negligent acts) or agreed to in writing, shall any Contributor be 159 | liable to You for damages, including any direct, indirect, special, 160 | incidental, or consequential damages of any character arising as a 161 | result of this License or out of the use or inability to use the 162 | Work (including but not limited to damages for loss of goodwill, 163 | work stoppage, computer failure or malfunction, or any and all 164 | other commercial damages or losses), even if such Contributor 165 | has been advised of the possibility of such damages. 166 | 167 | 9. Accepting Warranty or Additional Liability. While redistributing 168 | the Work or Derivative Works thereof, You may choose to offer, 169 | and charge a fee for, acceptance of support, warranty, indemnity, 170 | or other liability obligations and/or rights consistent with this 171 | License. However, in accepting such obligations, You may act only 172 | on Your own behalf and on Your sole responsibility, not on behalf 173 | of any other Contributor, and only if You agree to indemnify, 174 | defend, and hold each Contributor harmless for any liability 175 | incurred by, or claims asserted against, such Contributor by reason 176 | of your accepting any such warranty or additional liability. 177 | 178 | END OF TERMS AND CONDITIONS 179 | 180 | APPENDIX: How to apply the Apache License to your work. 181 | 182 | To apply the Apache License to your work, attach the following 183 | boilerplate notice, with the fields enclosed by brackets "{}" 184 | replaced with your own identifying information. (Don't include 185 | the brackets!) The text should be enclosed in the appropriate 186 | comment syntax for the file format. We also recommend that a 187 | file or class name and description of purpose be included on the 188 | same "printed page" as the copyright notice for easier 189 | identification within third-party archives. 190 | 191 | Copyright {yyyy} {name of copyright owner} 192 | 193 | Licensed under the Apache License, Version 2.0 (the "License"); 194 | you may not use this file except in compliance with the License. 195 | You may obtain a copy of the License at 196 | 197 | http://www.apache.org/licenses/LICENSE-2.0 198 | 199 | Unless required by applicable law or agreed to in writing, software 200 | distributed under the License is distributed on an "AS IS" BASIS, 201 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 202 | See the License for the specific language governing permissions and 203 | limitations under the License. 204 | --------------------------------------------------------------------------------