Kotlinで簡単に動画再生！たったの10選の方法

はじめに
●Kotlinとは？
- ○Kotlinの基本と特徴
●動画再生のための前提知識
- ○動画ファイルの種類と特性
- ○Kotlinでの動画再生に必要なライブラリ
●動画再生の実装
●応用例：カスタマイズして動画再生を楽しもう
●注意点と対処法
●カスタマイズ方法
- ○カスタムスキンの適用方法
- ○プラグインを用いた機能拡張
まとめ

はじめに

この記事を読めば、Kotlinを使用した動画再生の実装方法が身につくようになります。

Kotlinは現代のアプリ開発において、多くの開発者から高い評価を受けているプログラミング言語の一つです。

特にAndroidアプリ開発での利用が増えており、その多機能性と使いやすさが注目されています。

ここでは、そんなKotlinを使った動画再生方法に焦点を当て、ステップバイステップで詳しく解説していきます。

Kotlin初心者の方でも、この記事を通して動画再生の基本的な実装方法を学び、自身のアプリに組み込むことができるようになります。

●Kotlinとは？

Kotlinは、JetBrains社によって開発された静的型付けのプログラミング言語です。

Javaとの互換性を持ちつつ、よりシンプルで効率的にコードを書くことができる点が多くの開発者から評価されています。

特にAndroidアプリ開発においては、公式の開発言語としてGoogleからも推奨されているので、これからの動向を考えると、Kotlinを学ぶ価値は非常に高いです。

○Kotlinの基本と特徴

Kotlinは、現代の開発ニーズを満たすために設計された言語です。

Kotlinの主な特徴をいくつか挙げてみました。

Javaとの完全な互換性：KotlinはJavaと100%の互換性を持っているため、Javaのライブラリやフレームワークをそのまま利用することができます。既存のJavaコードベースにKotlinを追加して、両方の言語を混在させることも可能です。
シンプルで読みやすい構文：Kotlinの構文は、冗長性を排除し、直感的に読み解くことができます。これにより、コードのボリュームが減少し、バグの発生も少なくなります。
安全性：Kotlinには、null安全という機能が備わっているため、nullポインタのエラーを大幅に減少させることができます。
スクリプト言語としての利用：Kotlinは、コンパイル型言語であると同時に、スクリプト言語としても利用することができます。これにより、小さなスクリプトから大規模なアプリまで、幅広い用途でKotlinを活用することが可能です。
拡張関数：Kotlinでは、既存のクラスに新しいメソッドを追加することなく、その機能を拡張することができます。これにより、ライブラリのカスタマイズが容易になります。

●動画再生のための前提知識

動画再生をスムーズに実装するためには、いくつかの前提知識が必要です。

これから、動画ファイルの基本的な種類や特性、Kotlinでの動画再生を効果的に行うためのライブラリについて詳しく解説していきます。

○動画ファイルの種類と特性

動画ファイルは、その形式やコーデックによってさまざまな種類が存在します。

主な動画ファイルの種類としては、MP4、AVI、WMV、FLVなどが挙げられます。

MP4：MP4は、現在最もポピュラーな動画ファイル形式の一つです。高い圧縮率と品質を持ち、多くのデバイスやブラウザでサポートされています。
AVI：AVIは、マイクロソフトが開発した動画ファイル形式で、Windows環境で広く用いられています。しかし、ファイルサイズが大きくなりがちです。
WMV：WMVもマイクロソフトが開発した動画ファイル形式で、特にWindows Media Playerでの再生を目的としています。
FLV：FLVは、Adobe Flash Playerでの再生を前提とした動画ファイル形式です。しかし、近年はFlashのサポートが終了したため、新しいウェブサイトやアプリでの利用は減少しています。

これらの動画ファイル形式の中でも、Kotlinでの動画再生を考える際には、MP4形式が最も適していると言えます。

というのも、MP4は汎用性が高く、多くのライブラリやツールが対応しているため、実装が容易であり、再生時の互換性問題も少ないからです。

○Kotlinでの動画再生に必要なライブラリ

Kotlinで動画を再生するためには、専用のライブラリを利用することで、効率的に実装を進めることができます。

ExoPlayer：ExoPlayerは、Googleが提供しているAndroid向けのオープンソース動画再生ライブラリです。機能が豊富で、カスタマイズ性も高いため、多くのAndroidアプリで利用されています。
MediaPlayer：MediaPlayerは、Androidの標準ライブラリの一部として提供されている動画再生クラスです。基本的な動画再生機能は備わっていますが、ExoPlayerと比べると機能面での制限が多いです。
VLC for Android SDK：VLCは、多機能なメディアプレイヤーとして知られていますが、そのAndroid向けのSDKも提供されています。多くの動画ファイル形式に対応しているため、互換性の面で優れています。

これらのライブラリの中でも、特にExoPlayerは、その機能の豊富さとカスタマイズ性の高さから、Kotlinでの動画再生を実装する際の最初の選択肢として考えるのが良いでしょう。

●動画再生の実装

Kotlinを使用して動画を再生するプロセスは非常に直感的で、多くのライブラリやツールが存在するため、初心者でも取り組むことができます。

ここでは、動画再生の基本的な実装方法から、再生ボタンや停止ボタンの追加方法までを詳しく解説します。

○サンプルコード1：基本的な動画再生の実装

まずは、Kotlinでの基本的な動画再生の実装方法を紹介します。

import android.media.MediaPlayer
import android.net.Uri
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    private lateinit var mediaPlayer: MediaPlayer

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val videoUri = Uri.parse("android.resource://" + packageName + "/" + R.raw.sample_video)
        videoView.setVideoURI(videoUri)

        playButton.setOnClickListener {
            if (!videoView.isPlaying) {
                videoView.start()
            }
        }
    }
}

このコードでは、アクティビティが起動した際に動画ファイルを読み込み、再生ボタンがクリックされたときに動画を再生するようにしています。

具体的には、videoView.setVideoURI(videoUri)で動画のURIを設定し、videoView.start()で動画を再生しています。

このコードを実行すると、指定された動画ファイルがアプリ内でスムーズに再生されます。

○サンプルコード2：再生ボタンと停止ボタンの実装

次に、動画の再生と停止を制御するボタンの実装方法を見ていきましょう。

import android.media.MediaPlayer
import android.net.Uri
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    private lateinit var mediaPlayer: MediaPlayer

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val videoUri = Uri.parse("android.resource://" + packageName + "/" + R.raw.sample_video)
        videoView.setVideoURI(videoUri)

        playButton.setOnClickListener {
            if (!videoView.isPlaying) {
                videoView.start()
            }
        }

        stopButton.setOnClickListener {
            if (videoView.isPlaying) {
                videoView.pause()
                videoView.seekTo(0)
            }
        }
    }
}

上記のコードでは、playButtonという名前のボタンで動画を再生し、stopButtonという名前のボタンで動画を停止して最初の位置に戻すようになっています。

具体的には、videoView.pause()で動画の再生を一時停止し、videoView.seekTo(0)で動画を最初の位置に戻しています。

このコードを実行すると、ユーザーは再生ボタンと停止ボタンを使用して動画の再生と停止を自由に制御することができます。

○サンプルコード3：シークバーと連携した動画の操作

動画を再生する際、シークバーを使用して再生位置を指定することは、ユーザーエクスペリエンスを向上させる重要な機能の一つです。

シークバーを実装することで、動画の任意の位置に簡単にアクセスできるようになります。

Kotlinでシークバーと動画の連携を行う方法を解説します。

import android.os.Bundle
import android.widget.SeekBar
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        videoView.setMediaController(MediaController(this))

        seekBar.max = videoView.duration
        videoView.setOnPreparedListener {
            seekBar.progress = 0
            seekBar.max = videoView.duration

            seekBar.setOnSeekBarChangeListener(object: SeekBar.OnSeekBarChangeListener {
                override fun onProgressChanged(seekBar: SeekBar?, progress: Int, fromUser: Boolean) {
                    if (fromUser) {
                        videoView.seekTo(progress)
                    }
                }
                override fun onStartTrackingTouch(seekBar: SeekBar?) {}
                override fun onStopTrackingTouch(seekBar: SeekBar?) {}
            })
        }
    }
}

このコードでは、SeekBarを動画の長さに合わせて設定しています。

videoView.setOnPreparedListener内でシークバーの最大値を動画の長さ（videoView.duration）に設定しています。

さらに、seekBar.setOnSeekBarChangeListenerを使用して、ユーザーがシークバーの位置を変更した際に、動画の再生位置もそれに合わせて変わるようにしています。

具体的には、videoView.seekTo(progress)を使用して、シークバーの位置に合わせて動画の再生位置を更新しています。

シークバーを動かすと、動画の再生位置がシークバーの位置に応じて変わります。

このようにして、動画の任意の位置に瞬時にアクセスすることができるようになります。

○サンプルコード4：音量調整の実装

動画を再生する際、音量を調整することも重要な機能の一つです。

ユーザーは環境に合わせて音量を調整したい場合がありますので、この機能の実装方法を紹介します。

import android.content.Context
import android.media.AudioManager
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    private lateinit var audioManager: AudioManager

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
        volumeBar.max = audioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC)

        volumeBar.progress = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC)
        volumeBar.setOnSeekBarChangeListener(object: SeekBar.OnSeekBarChangeListener {
            override fun onProgressChanged(seekBar: SeekBar?, progress: Int, fromUser: Boolean) {
                audioManager.setStreamVolume(AudioManager.STREAM_MUSIC, progress, 0)
            }
            override fun onStartTrackingTouch(seekBar: SeekBar?) {}
            override fun onStopTrackingTouch(seekBar: SeekBar?) {}
        })
    }
}

このコードでは、AudioManagerを使用して、音量の最大値や現在の音量を取得し、それをSeekBarに設定しています。

また、ユーザーがシークバーを操作して音量を変更した場合、audioManager.setStreamVolumeで音量を更新しています。

シークバーを動かすと、動画の音量が変わります。

このようにして、動画の音量を簡単に調整することができます。

○サンプルコード5：フルスクリーンモードの実装

動画を視聴する際、フルスクリーンモードで視聴したい場合があります。

フルスクリーンモードにすることで、大画面での視聴体験を向上させることができます。

Kotlinでのフルスクリーンモードの実装方法を紹介します。

import android.os.Bundle
import android.view.View
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        fullscreenButton.setOnClickListener {
            if (window.decorView.systemUiVisibility == View.SYSTEM_UI_FLAG_VISIBLE) {
                window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_FULLSCREEN
            } else {
                window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_VISIBLE
            }
        }
    }
}

このコードでは、fullscreenButtonをクリックすると、フルスクリーンモードと通常モードを切り替えることができるようになっています。

具体的には、window.decorView.systemUiVisibilityを使用して、システムUIの表示を切り替えています。

フルスクリーンボタンをクリックすると、動画がフルスクリーンモードで表示され、再度クリックすると通常モードに戻ります。

このようにして、ユーザーは自由に表示モードを切り替えることができます。

●応用例：カスタマイズして動画再生を楽しもう

動画再生の基本的な機能は、さらに応用的な機能を実装することで、より魅力的な動画再生環境を作り上げることができます。

Kotlinを使用して、動画の再生をカスタマイズして、さらに楽しむための方法を紹介します。

○サンプルコード6：動画のリピート再生機能

一つの動画を繰り返し再生する、いわゆるリピート再生は、特定のシーンの確認や、好きな動画を何度も楽しむ際に便利です。

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        videoView.setMediaController(MediaController(this))
        videoView.setOnCompletionListener {
            videoView.seekTo(0)
            videoView.start()
        }
    }
}

このコードでは、動画が終了した際にsetOnCompletionListenerを用いて動画の再生位置を先頭に戻し、start()メソッドを使って動画を再び再生することで、リピート再生を実現しています。

○サンプルコード7：複数の動画を連続再生するプレイリスト機能

複数の動画を順番に再生するプレイリスト機能は、一つ一つの動画を手動で再生する手間を省き、スムーズな視聴体験ができるようになります。

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    private val videoList = listOf("path_to_video1", "path_to_video2", "path_to_video3")
    private var currentIndex = 0

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        videoView.setMediaController(MediaController(this))
        videoView.setVideoPath(videoList[currentIndex])
        videoView.start()

        videoView.setOnCompletionListener {
            currentIndex++
            if (currentIndex < videoList.size) {
                videoView.setVideoPath(videoList[currentIndex])
                videoView.start()
            } else {
                currentIndex = 0
                videoView.setVideoPath(videoList[currentIndex])
                videoView.start()
            }
        }
    }
}

このコードでは、動画のパスのリストvideoListを用意し、動画が終了するたびにcurrentIndexをインクリメントして次の動画を再生するようにしています。

全ての動画が再生された後は、最初の動画から再び再生を開始します。

○サンプルコード8：動画再生速度の調整機能

動画を再生する際、ユーザーが動画の速度を自由に調整できるようにする機能は、特に教育的なコンテンツや長い動画の確認において役立ちます。

Kotlinを使用して、この再生速度の調整機能を実装する方法を説明します。

import android.media.PlaybackParams
import android.os.Build
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        videoView.setMediaController(MediaController(this))

        speedButton.setOnClickListener {
            val playbackParams = PlaybackParams()
            playbackParams.speed = speedSeekBar.progress.toFloat() / 10.0f
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                videoView.playbackParams = playbackParams
            }
        }
    }
}

このコードでは、再生速度を調整するスライダー（speedSeekBar）の値に基づいて動画の再生速度を設定します。

PlaybackParamsクラスを使用して再生パラメータを設定し、それをvideoViewに適用します。

注意点として、この機能はAndroidのバージョンM以降でのみサポートされているので、バージョンチェックも行います。

このコードを実行すると、画面上に表示されたスライダーを動かすことで、動画の再生速度を簡単に変更することができるようになります。

例えば、スライダーの値を20に設定すると、動画は2倍速で再生されます。

○サンプルコード9：字幕の追加と表示機能

動画に字幕を追加することで、外国語の動画の理解を助けたり、音声が聞こえにくい環境でも内容を理解するのに役立ちます。

Kotlinで字幕を動画に追加し、それを表示する方法を紹介します。

まず、字幕ファイルを利用するための前提として、SRT形式の字幕ファイルを準備します。

SRTは広く利用される字幕ファイル形式で、多くの動画プレイヤーやエディタでサポートされています。

次に、Kotlinを使用して、動画プレイヤーに字幕を表示するための実装方法を説明します。

import android.net.Uri
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        videoView.setMediaController(MediaController(this))
        val videoUri: Uri = Uri.parse("path_to_your_video_file")
        val subtitleUri: Uri = Uri.parse("path_to_your_srt_file")

        videoView.setVideoURI(videoUri)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
            videoView.addSubtitleSource(contentResolver.openInputStream(subtitleUri), MediaFormat.createSubtitleFormat("text/srt", Locale.getDefault().language))
        }
        videoView.start()
    }
}

このコードでは、動画とSRT字幕ファイルの両方のパスを指定して、動画を再生する際に字幕を表示します。

addSubtitleSourceメソッドを使用して字幕ファイルを動画に関連付けます。

このコードを実行すると、動画が再生される際に、SRT字幕ファイルに基づいて字幕が画面上に表示されます。

このようにして、視聴者は動画の内容を字幕を通して理解することができます。

○サンプルコード10：動画のクリッピング機能

動画の特定の部分だけを切り取り、その部分だけを再生したい場合、クリッピング機能が非常に役立ちます。

Kotlinを使用して、動画のクリッピング機能を実装する方法を説明します。

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        videoView.setMediaController(MediaController(this))

        clipButton.setOnClickListener {
            val clipStart = startTimeEditText.text.toString().toInt() * 1000
            val clipEnd = endTimeEditText.text.toString().toInt() * 1000

            videoView.seekTo(clipStart)
            videoView.start()

            videoView.setOnPreparedListener { mp ->
                mp.setOnSeekCompleteListener {
                    if (videoView.currentPosition >= clipEnd) {
                        videoView.pause()
                    }
                }
            }
        }
    }
}

このコードでは、動画のクリッピング開始時間と終了時間を指定して、その範囲内だけを再生します。

seekToメソッドを使用して動画の特定の位置にジャンプし、OnSeekCompleteListenerを使用して指定した終了時間に動画を一時停止します。

このコードを実行すると、指定した範囲内だけ動画が再生され、その範囲外の部分は再生されません。

この機能を使用することで、動画の特定のシーンやハイライトだけを簡単に再生することができます。

●注意点と対処法

Kotlinで動画再生の実装を進める際、遭遇する可能性のある一般的な問題点とそれらの対処方法を詳しく解説します。

ここでは、動画のバッファリング問題、動画の互換性と対応フォーマット、ネットワーク接続時の動画の読み込みエラーに焦点を当てて説明します。

○動画のバッファリング問題の対処

動画の再生中にバッファリングの問題が発生すると、再生が途中で止まったり、画質が低下することがあります。

これは通常、ネットワークの速度やサーバーの応答速度に関連する問題です。

対処方法としては次のようなアプローチが考えられます。

動画の品質を自動的に調整する機能を実装します。
ユーザーが手動で動画の品質を選択できる機能を実装します。

videoView.setOnInfoListener { _, what, _ ->
    when (what) {
        MediaPlayer.MEDIA_INFO_BUFFERING_START -> {
            // バッファリング開始時の処理
        }
        MediaPlayer.MEDIA_INFO_BUFFERING_END -> {
            // バッファリング終了時の処理
        }
    }
    true
}

このコードでは、動画再生時にバッファリングが始まったり終わったりする際の情報を取得し、適切な処理を行います。

○互換性と対応フォーマット

すべての動画フォーマットがすべてのデバイスやブラウザでサポートされているわけではありません。

この非互換性は、特定のデバイスやブラウザで動画が正しく再生されない原因となることがあります。

対処方法としては、複数の動画フォーマットを用意して、デバイスやブラウザに適したフォーマットを動的に選択して再生する方法が考えられます。

○ネットワーク接続時の動画の読み込みエラーへの対応

ネットワークの不安定さや接続の切断は、動画の読み込みエラーの一般的な原因です。

このような問題が発生した場合、ユーザーに適切なフィードバックを提供し、再試行の機会を提供することが重要です。

videoView.setOnErrorListener { _, what, extra ->
    when (what) {
        MediaPlayer.MEDIA_ERROR_UNKNOWN -> {
            // 未知のエラーが発生した場合の処理
        }
        MediaPlayer.MEDIA_ERROR_SERVER_DIED -> {
            // サーバーエラーが発生した場合の処理
        }
    }
    true
}

このコードを使用すると、動画の読み込み中にエラーが発生した場合に、そのエラーのタイプに基づいて処理を分岐することができます。

ユーザーにエラーメッセージを表示するなどの対応を行うことで、ユーザーエクスペリエンスを向上させることができます。

●カスタマイズ方法

Kotlinで動画再生を実装する際、デフォルトの設定だけではユーザーのニーズを満たすことができないことがあります。そこで、カスタマイズが必要になります。

ここでは、動画再生のカスタマイズ方法として、カスタムスキンの適用やプラグインを用いた機能拡張について解説します。

○カスタムスキンの適用方法

動画再生時のデザインやUIをカスタマイズするために、カスタムスキンを適用する方法が考えられます。

これにより、動画プレイヤーのボタンの形や色、配置などを自由に変更することができます。

まず、カスタムスキンのXMLファイルを作成します。

<!-- res/layout/custom_video_skin.xml -->
<RelativeLayout
    ...>
    <VideoView
        ...
        android:id="@+id/videoView" />
    <Button
        ...
        android:text="再生" />
    <Button
        ...
        android:text="停止" />
</RelativeLayout>

次に、このXMLファイルを利用して動画再生のUIをカスタマイズします。

val videoView = findViewById<VideoView>(R.id.videoView)
videoView.setVideoPath("動画のパス")
videoView.setMediaController(MediaController(this))
videoView.start()

このコードを実行すると、定義したカスタムスキンが動画プレイヤーに適用され、再生や停止のボタンがカスタマイズされた位置やデザインで表示されます。

○プラグインを用いた機能拡張

動画再生の基本機能を超えて、さらに高度な機能を追加したい場合は、プラグインを用いる方法が考えられます。

これにより、動画再生速度の調整や字幕の表示などの拡張機能を追加することができます。

例として、動画再生速度を調整するプラグインを実装する方法を紹介します。

class SpeedAdjustPlugin : MediaPlugin {
    fun setSpeed(speed: Float) {
        mediaPlayer.playbackSpeed = speed
    }
}

val speedPlugin = SpeedAdjustPlugin()
videoView.addPlugin(speedPlugin)

このコードで動画の再生速度を調整するプラグインを追加し、指定した速度で動画を再生することができます。