Introduction

On Android, the simplest way to open a YouTube video from your app is usually an intent. Instead of building your own video player or deep integration first, you can ask the system to hand the video URL or YouTube URI to an app that knows how to play it.

That approach is lightweight and user-friendly, but it needs one practical safeguard: the YouTube app may not be installed. A good implementation therefore tries the YouTube-specific intent first and falls back to a browser URL if necessary.

The Basic Intent Approach

A YouTube video can be launched with Intent.ACTION_VIEW and a video URI. A common pattern is to use the vnd.youtube: scheme for the YouTube app.

1import android.content.ActivityNotFoundException
2import android.content.Intent
3import android.net.Uri
4import androidx.appcompat.app.AppCompatActivity
5
6class MainActivity : AppCompatActivity() {
7
8    fun openVideo(videoId: String) {
9        val appIntent = Intent(Intent.ACTION_VIEW, Uri.parse("vnd.youtube:$videoId"))
10        startActivity(appIntent)
11    }
12}

If the YouTube app is installed and registered for that scheme, the video opens directly in the app.

Add a Browser Fallback

Relying only on the app-specific URI is fragile. A better version catches the case where no matching activity exists and then opens the normal web URL.

1import android.content.ActivityNotFoundException
2import android.content.Intent
3import android.net.Uri
4import androidx.appcompat.app.AppCompatActivity
5
6class MainActivity : AppCompatActivity() {
7
8    fun openVideo(videoId: String) {
9        val appIntent = Intent(Intent.ACTION_VIEW, Uri.parse("vnd.youtube:$videoId"))
10        val webIntent = Intent(
11            Intent.ACTION_VIEW,
12            Uri.parse("https://www.youtube.com/watch?v=$videoId")
13        )
14
15        try {
16            startActivity(appIntent)
17        } catch (e: ActivityNotFoundException) {
18            startActivity(webIntent)
19        }
20    }
21}

This produces a much better user experience because the action still succeeds even when the dedicated app is missing.

Opening from a Button Click

A full example in an activity might look like this:

1import android.os.Bundle
2import android.widget.Button
3import androidx.appcompat.app.AppCompatActivity
4
5class MainActivity : AppCompatActivity() {
6
7    override fun onCreate(savedInstanceState: Bundle?) {
8        super.onCreate(savedInstanceState)
9        setContentView(R.layout.activity_main)
10
11        val button = findViewById<Button>(R.id.playButton)
12        button.setOnClickListener {
13            openVideo("dQw4w9WgXcQ")
14        }
15    }
16
17    private fun openVideo(videoId: String) {
18        val appIntent = android.content.Intent(
19            android.content.Intent.ACTION_VIEW,
20            android.net.Uri.parse("vnd.youtube:$videoId")
21        )
22        val webIntent = android.content.Intent(
23            android.content.Intent.ACTION_VIEW,
24            android.net.Uri.parse("https://www.youtube.com/watch?v=$videoId")
25        )
26
27        try {
28            startActivity(appIntent)
29        } catch (e: android.content.ActivityNotFoundException) {
30            startActivity(webIntent)
31        }
32    }
33}

This is enough for many apps that just need to hand off playback to YouTube.

When an Intent Is the Right Tool

Using an intent is a good choice when:

• you want to open a standard YouTube video
• you do not need custom embedded playback controls
• you are happy to let YouTube or the browser own the playback experience

If you need inline playback inside your own UI, then an embedded solution or web-based player approach is a different design problem.

Check for Intent Resolution Explicitly

Instead of relying only on exceptions, you can also test whether the intent resolves before launching it.

1val appIntent = Intent(Intent.ACTION_VIEW, Uri.parse("vnd.youtube:$videoId"))
2if (appIntent.resolveActivity(packageManager) != null) {
3    startActivity(appIntent)
4}

This is slightly more explicit and avoids an exception-driven control path.

Common Pitfalls

One common mistake is passing a full YouTube URL into the vnd.youtube: scheme. That scheme expects a video ID, not the whole web address.

Another issue is assuming the YouTube app is always installed. On many devices it is, but not all. Without a fallback, your app can fail with ActivityNotFoundException.

It is also easy to forget that intent-based playback hands control to another app. If your requirement is an embedded player inside your own screen, opening an external intent is not the right solution.

Finally, make sure the video ID is valid. If the ID is malformed, the intent may open but the target video will not play correctly.

Summary

• On Android, the usual way to open a YouTube video is Intent.ACTION_VIEW with a YouTube or web URI.
• 'vnd.youtube:VIDEO_ID is useful when you want to target the YouTube app directly.'
• Always provide a fallback to the normal web URL in case the YouTube app is unavailable.
• Use intent resolution checks or exception handling to avoid crashes.
• Intent-based playback is best when you want to hand video playback off to YouTube rather than embed it inside your own UI.