Initial commit of the hello-oboe sample

Change-Id: I3af2bc33b56608f18b6fbe1a912575ba71828b4d

Author: dturner

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "oboe/hello-oboe/src/main/cpp/oboe"]
+	path = oboe/hello-oboe/src/main/cpp/oboe
+	url = sso://devrel/libraries/android/oboe

aaudio/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
-#Fri Mar 17 15:07:01 PDT 2017
+#Mon Oct 16 16:25:02 BST 2017
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-3.3-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip

audio-device/build.gradle

@@ -2,9 +2,9 @@ apply plugin: 'com.android.library'
 
 android {
     compileSdkVersion 26
-    buildToolsVersion "26.0.0"
+    buildToolsVersion '26.0.2'
     defaultConfig {
-        minSdkVersion 26
+        minSdkVersion 16
         targetSdkVersion 26
         versionCode 1
         versionName "1.0"

audio-device/src/main/java/com/google/sample/audio_device/AudioDeviceListEntry.java

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 
+import android.annotation.TargetApi;
 import android.media.AudioDeviceInfo;
 import android.media.AudioManager;
 
@@ -75,6 +76,7 @@ public int hashCode() {
      *                      GET_DEVICES_INPUTS.
      * @return A list of AudioDeviceListEntry objects
      */
+    @TargetApi(23)
     static List<AudioDeviceListEntry> createListFrom(AudioDeviceInfo[] devices, int directionType){
 
         List<AudioDeviceListEntry> listEntries = new Vector<>();

audio-device/src/main/java/com/google/sample/audio_device/AudioDeviceSpinner.java

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 
+import android.annotation.TargetApi;
 import android.content.Context;
 import android.content.res.Resources.Theme;
 import android.media.AudioDeviceCallback;
@@ -29,66 +30,77 @@ public class AudioDeviceSpinner extends Spinner {
 
     private static final int AUTO_SELECT_DEVICE_ID = 0;
     private static final String TAG = AudioDeviceSpinner.class.getName();
-    private int mDirectionType = AudioManager.GET_DEVICES_OUTPUTS;
+    private int mDirectionType;
+    private AudioDeviceAdapter mDeviceAdapter;
+    private AudioManager mAudioManager;
 
     public AudioDeviceSpinner(Context context){
         super(context);
+        setup(context);
     }
 
     public AudioDeviceSpinner(Context context, int mode){
         super(context, mode);
+        setup(context);
     }
 
     public AudioDeviceSpinner(Context context, AttributeSet attrs){
         super(context, attrs);
+        setup(context);
     }
 
     public AudioDeviceSpinner(Context context, AttributeSet attrs, int defStyleAttr){
         super(context, attrs, defStyleAttr);
+        setup(context);
     }
 
     public AudioDeviceSpinner(Context context, AttributeSet attrs, int defStyleAttr, int mode){
         super(context, attrs, defStyleAttr, mode);
+        setup(context);
     }
 
     public AudioDeviceSpinner(Context context, AttributeSet attrs, int defStyleAttr,
                               int defStyleRes, int mode){
         super(context, attrs, defStyleAttr, defStyleRes, mode);
+        setup(context);
     }
     public AudioDeviceSpinner(Context context, AttributeSet attrs, int defStyleAttr,
                               int defStyleRes, int mode, Theme popupTheme){
         super(context, attrs, defStyleAttr, defStyleRes, mode, popupTheme);
+        setup(context);
     }
 
-    public void setDirectionType(int directionType){
-        this.mDirectionType = directionType;
-        setupAdapter();
-    }
+    private void setup(Context context){
+        mAudioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
 
-    private void setupAdapter(){
-
-        Context context = getContext();
-        AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
-
-        final AudioDeviceAdapter deviceAdapter = new AudioDeviceAdapter(context);
-        setAdapter(deviceAdapter);
+        mDeviceAdapter = new AudioDeviceAdapter(context);
+        setAdapter(mDeviceAdapter);
 
         // Add a default entry to the list and select it
-        deviceAdapter.add(new AudioDeviceListEntry(AUTO_SELECT_DEVICE_ID,
+        mDeviceAdapter.add(new AudioDeviceListEntry(AUTO_SELECT_DEVICE_ID,
                 context.getString(R.string.auto_select)));
         setSelection(0);
+    }
+
+    @TargetApi(23)
+    public void setDirectionType(int directionType){
+        this.mDirectionType = directionType;
+        setupAudioDeviceCallback();
+    }
+
+    @TargetApi(23)
+    private void setupAudioDeviceCallback(){
 
-        // Listen for changes
         // Note that we will immediately receive a call to onDevicesAdded with the list of
         // devices which are currently connected.
-        audioManager.registerAudioDeviceCallback(new AudioDeviceCallback() {
+        mAudioManager.registerAudioDeviceCallback(new AudioDeviceCallback() {
             @Override
             public void onAudioDevicesAdded(AudioDeviceInfo[] addedDevices) {
 
                 List<AudioDeviceListEntry> deviceList =
                         AudioDeviceListEntry.createListFrom(addedDevices, mDirectionType);
                 if (deviceList.size() > 0){
-                    deviceAdapter.addAll(deviceList);
+                    mDeviceAdapter.addAll(deviceList);
                 }
             }
 
@@ -97,7 +109,7 @@ public void onAudioDevicesRemoved(AudioDeviceInfo[] removedDevices) {
                 List<AudioDeviceListEntry> deviceList =
                         AudioDeviceListEntry.createListFrom(removedDevices, mDirectionType);
                 for (AudioDeviceListEntry entry : deviceList){
-                    deviceAdapter.remove(entry);
+                    mDeviceAdapter.remove(entry);
                 }
             }
         }, null);

oboe/README.md

@@ -0,0 +1,62 @@
+Oboe Samples
+==============
+These samples demonstrate how to use the Oboe library:
+
+1. hello-oboe: creates an output (playback) stream and plays a
+sine wave when you tap the screen
+
+Pre-requisites
+-------------
+* Android device or emulator running API 16 (Jelly Bean) or above
+* [Android SDK 26](https://developer.android.com/about/versions/oreo/android-8.0-migration.html#ptb)
+* [NDK r16](https://developer.android.com/ndk/downloads/index.html) or above
+* [Android Studio 2.3.0+](https://developer.android.com/studio/index.html)
+
+Getting Started
+---------------
+1. [Install Android Studio](https://developer.android.com/studio/index.html)
+1. Clone this sample repository
+1. Import the sample project into Android Studio
+    - File -> New -> Import Project
+    - Browse to oboe/build.gradle
+    - Click "OK"
+1. Click Run -> Run, choose the sample you wish to run
+
+Screenshots
+-----------
+![hello-oboe-screenshot](hello-oboe-screenshot.png)
+
+Support
+-------
+If you've found an error in these samples, please [file an issue](https://github.com/googlesamples/android-audio-high-performance/issues/new).
+
+Patches are encouraged, and may be submitted by [forking this project](https://github.com/googlesamples/android-audio-high-performance/fork) and
+submitting a pull request through GitHub. Please see [CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
+
+- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
+- [Google+ Community](https://plus.google.com/communities/105153134372062985968)
+- [Android Tools Feedback](http://tools.android.com/feedback)
+
+
+License
+-------
+Copyright 2017 Google, Inc.
+
+Licensed to the Apache Software Foundation (ASF) under one or more contributor
+license agreements.  See the NOTICE file distributed with this work for
+additional information regarding copyright ownership.  The ASF licenses this
+file to you under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License.  You may obtain a copy of
+the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+License for the specific language governing permissions and limitations under
+the License.
+
+Version History
+---------------
+- 18th October 2017 - Initial version

oboe/TODO

@@ -0,0 +1,7 @@
+Oboe Samples TODO
+- Figure out a way of not duplicating the "common" module in both the aaudio and oboe samples.
+This can be done:
+https://stackoverflow.com/questions/17479076/android-studio-add-external-project-to-build-gradle
+- Buffer size selection isn't working - does it work in hello-aaudio?
+- Getting crash on Pixel 2 when changing playback device quickly, probably need to have a
+"restarting streams" state which blocks calls to change the device id

oboe/build.gradle

@@ -0,0 +1,37 @@
+/*
+ * Copyright 2015 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+
+
+buildscript {
+    repositories {
+        jcenter()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:3.0.0-rc1'
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+}
+
+allprojects {
+    repositories {
+        jcenter()
+    }
+}

oboe/gradle.properties

@@ -0,0 +1,35 @@
+#
+# Copyright 2015 The Android Open Source Project
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+# Default value: -Xmx10248m -XX:MaxPermSize=256m
+# org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true

oboe/gradle/wrapper/gradle-wrapper.jar

@@ -0,0 +1,6 @@
+#Thu Oct 12 11:30:59 BST 2017
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip