samples/browseable/BeamLargeFiles/src/com.example.android.beamlargefiles/BeamLargeFilesFragment.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)
}