Add video annotation to PDF in Java for Android

1
/*
2
 *   Copyright © 2018-2025 PSPDFKit GmbH. All rights reserved.
3
 *
4
 *   The PSPDFKit Sample applications are licensed with a modified BSD license.
5
 *   Please see License for details. This notice may not be removed from this file.
6
 */
7

8
package com.pspdfkit.catalog.examples.java;
9

10
import android.content.Context;
11
import android.content.Intent;
12
import android.net.Uri;
13
import androidx.annotation.NonNull;
14
import com.pspdfkit.catalog.R;
15
import com.pspdfkit.catalog.SdkExample;
16
import com.pspdfkit.catalog.examples.java.activities.MultimediaAnnotationsActivity;
17
import com.pspdfkit.catalog.tasks.ExtractAssetTask;
18
import com.pspdfkit.configuration.activity.PdfActivityConfiguration;
19
import com.pspdfkit.ui.PdfActivityIntentBuilder;
20

21
/** This example showcases how to dynamically add multimedia content to a PDF document. */
22
public class DynamicMultimediaAnnotationExample extends SdkExample {
23

24
    public DynamicMultimediaAnnotationExample(Context context) {
25
        super(
26
                context.getString(R.string.dynamicMultimediaExampleTitle),
27
                context.getString(R.string.dynamicMultimediaExampleDescription));
28
    }
29

30
    @Override
31
    public void launchExample(@NonNull Context context, @NonNull PdfActivityConfiguration.Builder configuration) {
32
        configuration.videoPlaybackEnabled(true);
33

34
        // Before launching the example, we extract one video file to the private app folder. This
35
        // file will be used to dynamically add
36
        // another link annotation to the document at runtime.
37
        ExtractAssetTask.extract("media/videos/small.mp4", getTitle(), context, false, "mp4", videoFile -> {
38
            // Next extract the demo document and launch it.
39
            ExtractAssetTask.extract(WELCOME_DOC, getTitle(), context, documentFile -> {
40
                // For normal multimedia content playback, it is not necessary to
41
                // subclass PdfActivity as no custom code is required (only
42
                // annotations using
43
                // the pspdfkit:// scheme have to be present). However, if you want
44
                // to dynamically add multimedia annotations to a document, it is
45
                // preferable
46
                // to do this using a custom activity class (as done by this
47
                // example).
48
                final Intent intent = PdfActivityIntentBuilder.fromUri(context, Uri.fromFile(documentFile))
49
                        .configuration(configuration.build())
50
                        .activityClass(MultimediaAnnotationsActivity.class)
51
                        .build();
52

53
                // Pass the file system path to our video file to the activity. The
54
                // activity will use the path to dynamically add a multimedia link
55
                // annotation
56
                // to the PDF for opening the extracted video.
57
                intent.putExtra(MultimediaAnnotationsActivity.EXTRA_VIDEO_PATH, videoFile.getAbsolutePath());
58
                context.startActivity(intent);
59
            });
60
        });
61
    }
62
}