77b5d394ff
Synced to developers/samples/android commit 97b2cfe5ba6d8fa8daaf3273141b321b5fe9e910. Change-Id: I360cfa147e71dd519b841df41b4e878f86b9b27b
99 lines
4.1 KiB
Java
99 lines
4.1 KiB
Java
/*
|
|
* Copyright (C) 2013 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.
|
|
*/
|
|
|
|
package com.example.android.beamlargefiles;
|
|
|
|
import android.app.Activity;
|
|
import android.net.Uri;
|
|
import android.nfc.NfcAdapter;
|
|
import android.nfc.NfcEvent;
|
|
import android.os.Bundle;
|
|
import android.support.v4.app.Fragment;
|
|
import android.util.Log;
|
|
|
|
/**
|
|
* This class demonstrates how to use Beam to send files too large to transfer reliably via NFC.
|
|
*
|
|
* <p>While any type of data can be placed into a normal NDEF messages, NFC is not considered
|
|
* "high-speed" communication channel. Large images can easily take > 30 seconds to transfer.
|
|
* Because NFC requires devices to be in extremely close proximity, this is not ideal.
|
|
*
|
|
* <p>Instead, Android 4.2+ devices can use NFC to perform an initial handshake, before handing
|
|
* off to a faster communication channel, such as Bluetooth, for file transfer.
|
|
*
|
|
* <p>The tradeoff is that this application will not be invoked on the receiving device. Instead,
|
|
* the transfer will be handled by the OS. The user will be shown a notification when the transfer
|
|
* is complete. Selecting the notification will open the file in the default viewer for its MIME-
|
|
* type. (If it's important that your application be used to open the file, you'll need to register
|
|
* an intent-filter to watch for the appropriate MIME-type.)
|
|
*/
|
|
public class BeamLargeFilesFragment extends Fragment implements NfcAdapter.CreateBeamUrisCallback {
|
|
|
|
private static final String TAG = "BeamLargeFilesFragment";
|
|
/** Filename that is to be sent for this activity. Relative to /assets. */
|
|
private static final String FILENAME = "stargazer_droid.jpg";
|
|
/** Content provider URI. */
|
|
private static final String CONTENT_BASE_URI =
|
|
"content://com.example.android.beamlargefiles.files/";
|
|
|
|
/**
|
|
* Standard lifecycle event. Registers a callback for large-file transfer, by calling
|
|
* NfcAdapter.setBeamPushUrisCallback().
|
|
*
|
|
* Note: Like sending NDEF messages over standard Android Beam, there is also a non-callback
|
|
* API available. See: NfcAdapter.setBeamPushUris().
|
|
*
|
|
* @param savedInstanceState Saved instance state.
|
|
*/
|
|
@Override
|
|
public void onCreate(Bundle savedInstanceState) {
|
|
super.onCreate(savedInstanceState);
|
|
setHasOptionsMenu(true);
|
|
Activity a = getActivity();
|
|
|
|
// Setup Beam to transfer a large file. Note the call to setBeamPushUrisCallback().
|
|
// BEGIN_INCLUDE(setBeamPushUrisCallback)
|
|
NfcAdapter nfc = NfcAdapter.getDefaultAdapter(a);
|
|
if (nfc != null) {
|
|
Log.w(TAG, "NFC available. Setting Beam Push URI callback");
|
|
nfc.setBeamPushUrisCallback(this, a);
|
|
} else {
|
|
Log.w(TAG, "NFC is not available");
|
|
}
|
|
// END_INCLUDE(setBeamPushUrisCallback)
|
|
}
|
|
|
|
/**
|
|
* Callback for Beam events (large file version). The return value here should be an array of
|
|
* content:// or file:// URIs to send.
|
|
*
|
|
* Note that the system must have read access to whatever URIs are provided here.
|
|
*
|
|
* @param nfcEvent NFC event which triggered callback
|
|
* @return URIs to be sent to remote device
|
|
*/
|
|
// BEGIN_INCLUDE(createBeamUris)
|
|
@Override
|
|
public Uri[] createBeamUris(NfcEvent nfcEvent) {
|
|
Log.i(TAG, "Beam event in progress; createBeamUris() called.");
|
|
// Images are served using a content:// URI. See AssetProvider for implementation.
|
|
Uri photoUri = Uri.parse(CONTENT_BASE_URI + FILENAME);
|
|
Log.i(TAG, "Sending URI: " + photoUri);
|
|
return new Uri[] {photoUri};
|
|
}
|
|
// END_INCLUDE(createBeamUris)
|
|
}
|