Sample App

public class MainActivity extends AppCompatActivity {

    private static final String TAG = MainActivity.class.getSimpleName();
    private StmService stmService;
    private Boolean isStmServiceBound = false;
    private Shout newlyCreatedShout;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Intent to bind to the Shout to Me service
        Intent intent = new Intent(this, StmService.class);
        bindService(intent, stmServiceConnection, Context.BIND_AUTO_CREATE);

        // Show user a Dialog to update Google Play Services if required version is not installed
        GoogleApiAvailability googleApiAvailability = GoogleApiAvailability.getInstance();
        int val = googleApiAvailability.isGooglePlayServicesAvailable(this);
        if (val != ConnectionResult.SUCCESS) {
            Dialog gpsErrorDialog = googleApiAvailability.getErrorDialog(this, val, 2);
            gpsErrorDialog.show();
        }

        final EditText editText = (EditText) findViewById(R.id.editTextUserHandle);
        editText.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                editText.setError(null);
            }
        });
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();

        if (isStmServiceBound) {
            unbindService(stmServiceConnection);
        }
    }

    public void launchRecordingOverlay(View view) {
        if (isStmServiceBound) {
            stmService.setShoutCreationCallback(new Callback<Shout>() {
                @Override
                public void onSuccess(StmResponse<Shout> stmResponse) {
                    newlyCreatedShout = stmResponse.get();
                    showDeleteButton();
                }

                @Override
                public void onFailure(StmError stmError) {
                    // An error occurred during shout creation
                }
            });

            Intent intent = new Intent(this, StmRecorderActivity.class);

            // REQUIRED: Set the maximum length of recording time allowed in seconds.
            intent.putExtra(StmRecorderActivity.MAX_RECORDING_TIME_IN_SECONDS, 15);

            startActivityForResult(intent, 1);
        }
    }

    protected void onActivityResult(int requestCode, int resultCode, Intent data) {

        if (requestCode == 1) {
            if(resultCode == RESULT_OK){
                String result = data.getStringExtra(StmRecorderActivity.ACTIVITY_RESULT);

                if (result.equals(StmService.FAILURE)) {
                    String failureReasonCode = data.getStringExtra(StmRecorderActivity.ACTIVITY_REASON);
                    if (failureReasonCode.equals(StmRecorderActivity.RECORD_AUDIO_PERMISSION_DENIED)) {

                        // User has not granted access to record audio.  Ask the user for permission now.
                        ActivityCompat.requestPermissions(this, new String[] { Manifest.permission.RECORD_AUDIO }, 0);
                    }
                }
            }
            if (resultCode == RESULT_CANCELED) {
                // Recording was cancelled
            }
        }
    }

    public void setUserHandle(View view) {
        if (isStmServiceBound) {
            final EditText editText = (EditText)findViewById(R.id.editTextUserHandle);
            String newHandle = editText.getText().toString();

            UpdateUserRequest updateUserRequest = new UpdateUserRequest();
            updateUserRequest.setHandle(newHandle);

            stmService.updateUser(updateUserRequest, new Callback<User>() {
                @Override
                public void onSuccess(final StmResponse<User> stmResponse) {
                    editText.setError(null);
                    editText.setText(stmService.getUser().getHandle());
                }

                @Override
                public void onFailure(final StmError stmError) {
                    editText.setError(stmError.getMessage());
                    editText.setText(stmService.getUser().getHandle());
                }
            });
        }
    }

    public void deleteShout(View view) {
        if (newlyCreatedShout != null) {
            newlyCreatedShout.delete(new Callback<String>() {
                @Override
                public void onSuccess(StmResponse<String> stmResponse) {
                    if (stmResponse.get().equals(StmService.SUCCESS)) {
                        hideDeleteButton();
                    }
                }

                @Override
                public void onFailure(StmError stmError) {
                    // An error occurred deleting shout
                }
            });
        }
    }

    private void showDeleteButton() {
        Button deleteButton = (Button) findViewById(R.id.deleteShoutButton);
        deleteButton.setVisibility(View.VISIBLE);
    }

    private void hideDeleteButton() {
        Button deleteButton = (Button) findViewById(R.id.deleteShoutButton);
        deleteButton.setVisibility(View.INVISIBLE);
    }

    private ServiceConnection stmServiceConnection = new ServiceConnection() {

        @Override
        public void onServiceConnected(ComponentName className,
                                       IBinder service) {
            // We've bound to StmService, cast the IBinder and get StmService instance
            StmService.StmBinder binder = (StmService.StmBinder) service;
            stmService = binder.getService();
            isStmServiceBound = true;

            // You can also set the channel programmatically if you have access to more than one channel
            // stmService.setChannelId("[channel ID]");

            // Get a reference to the UI text box and update it with data from the server
            final EditText handleEditText = (EditText) findViewById(R.id.editTextUserHandle);
            stmService.getUser(new Callback<User>() {
                @Override
                public void onSuccess(final StmResponse<User> stmResponse) {
                    handleEditText.setText(stmResponse.get().getHandle());
                }

                @Override
                public void onFailure(final StmError stmError) {
                    // Could not retrieve Shout to Me user.
                }
            });
        }

        @Override
        public void onServiceDisconnected(ComponentName arg0) {
            isStmServiceBound = false;
        }
    };
}