ビデオプレーヤーの開発

シーン紹介

ビデオの再生には、再生制御、再生設定、および再生開始/停止、再生速度設定、ループ再生するかどうかなどの再生クエリが含まれます。

インターフェースの説明

ビデオ再生クラス Player のメインインターフェイス

インターフェース名	機能説明
プレーヤー(コンテキストコンテキスト)	Player インスタンスを作成します。
setSource(ソースソース)	メディアソースを設定します。
準備（）	遊ぶ準備ができました。
遊ぶ（）	プレイを開始します。
一時停止（）	再生を一時停止します。
ストップ（）	遊びをやめてください。
rewindTo(長いマイクロ秒)	ドラッグアンドドロップして再生します。
setVolume(浮動小数点ボリューム)	再生音量を調整します。
setVideoSurface(表面)	ビデオ再生のウィンドウを設定します。
EnableSingleLooping(ブールループ)	シングルループに設定します。
isSingleLooping()	単一トラックがループ再生されているかどうかを確認します。
isNowPlaying()	再生を確認します。
getCurrentTime()	現在の再生位置を取得します。
getDuration()	メディアファイルの合計時間を取得します。
getVideoWidth()	ビデオの幅を取得します。
getVideoHeight()	ビデオの高さを取得します。
setPlaybackSpeed(フロート速度)	再生速度を設定します。
getPlaybackSpeed()	再生速度を取得します。
setAudioStreamType(int型)	音声の種類を設定します。
getAudioStreamType()	オーディオの種類を取得します。
setNextPlayer(次のプレーヤー)	現在の再生が終了したら、次のプレーヤーを設定します。
リセット()	プレーヤーをリセットします。
リリース（）	再生リソースを解放します。
setPlayerCallback(IPlayerCallback コールバック)	プレーヤーのイベント通知または例外通知を受け取るコールバックを登録します。

開発ステップ

1. Player インスタンスを作成するには、Player(Context context) を呼び出して、このデバイスで再生するためのローカルプレーヤーを作成します。

2. データソースオブジェクトを構築し、Player インスタンスの setSource(Source source) メソッドを呼び出してメディアソースを設定します。コード例は次のとおりです。

private Context context = this;
private HiLogLabel TAG = new HiLogLabel(HiLog.DEBUG, 0xD000500, "MainAblityTest");
Player player = new Player(context);
File file = new File("/data/data/xxxx/files/test_audio.mp4"); // 根据实际情况设置文件路径
FileInputStream in = new FileInputStream(file);
FileDescriptor fd = in.getFD(); // 从输入流获取FD对象
Source source = new Source(fd);
player.setSource(source);
player.prepare();
player.setPlayerCallback(new Callback());
player.play();
player.stop();

3. prepare() を呼び出して再生の準備をします。

4. IPlayerCallback を構築し、IPlayerCallback を通じて、対応するコールバック関数で準備完了や再生終了などのイベントに応答できます。コード例は次のとおりです。

    public class Callback implements Player.IPlayerCallback {

        @Override
        public void onPrepared() {
            HiLog.info(TAG, "Player is now prepared,and ready to play");
        }

        @Override
        public void onMessage(int i, int i1) {

        }

        @Override
        public void onError(int errorType, int errorCode) {
            HiLog.error(TAG, "PlayerCallback onError errorType: %{public}d, errorCode: %{public}d", errorType, errorCode);
        }

        @Override
        public void onResolutionChanged(int i, int i1) {

        }

        @Override
        public void onPlayBackComplete() {
            HiLog.info(TAG, "PlayerCallback onPlayBackComplete");
  
        }

        @Override
        public void onRewindToComplete() {

        }

        @Override
        public void onBufferingChange(int i) {

        }

        @Override
        public void onNewTimedMetaData(Player.MediaTimedMetaData mediaTimedMetaData) {

        }

        @Override
        public void onMediaTimeIncontinuity(Player.MediaTimeInfo mediaTimeInfo) {

        }
    }

5. play() メソッドを呼び出して再生を開始します。

6. (オプション) 再生を一時停止および再開するには、pause() メソッドと play() メソッドを呼び出します。

7. (オプション) rewindTo(long microseconds) メソッドを呼び出して、再生中にドラッグアンドドロップ機能を実装します。

8. (オプション) getDuration() メソッドと getCurrentTime() メソッドを呼び出して、合計再生時間と現在の再生位置を取得します。

9. stop() メソッドを呼び出して再生を停止します。

10. 再生が終了したら、release() を呼び出してリソースを解放します。

ビデオ録画開発

シーン紹介

ビデオ録画の主な作業は、ビデオ/オーディオソースを選択した後、ビデオ/オーディオファイルを記録して生成することです。

インターフェースの説明

ビデオ録画クラス Recorder のメインインターフェイス

インターフェース名	機能説明
レコーダー（）	Recorder インスタンスを作成します。
setSource(ソースソース)	オーディオとビデオのソースを設定します。
setAudioProperty(AudioProperty プロパティ)	オーディオのプロパティを設定します。
setVideoProperty(VideoProperty プロパティ)	ビデオのプロパティを設定します。
setStorageProperty(StorageProperty プロパティ)	オーディオとビデオのストレージのプロパティを設定します。
準備（）	リソースを記録する準備をします。
始める（）	録音を開始。
ストップ（）	録音を停止します。
一時停止（）	録音を一時停止します。
履歴書（）	録音を再開します。
リセット()	録音をリセットします。
setRecorderLocation(浮動小数点緯度、浮動小数点経度)	ビデオの緯度と経度を設定します。
setOutputFormat(int 出力フォーマット)	出力ファイル形式を設定します。
getVideoSurface()	ビデオウィンドウを取得します。
setRecorderProfile(RecorderProfile profile)	设置媒体录制配置信息。
registerRecorderListener(IRecorderListener listener)	注册媒体录制回调。
release()	释放媒体录制资源。

开发步骤

1. 调用Recorder()方法，创建Recorder实例。

2. 构造数据源对象，并调用Recorder实例的setSource(Source source)方法，设置媒体源，代码示例如下：

Recorder recorder = new Recorder();
Source source = new Source();
source.setRecorderAudioSource(Recorder.AudioSource.MIC);
source.setRecorderVideoSource(Recorder.VideoSource.SURFACE);
recorder.setSource(source);

3. 调用setOutputFormat(int outputFormat)方法，设置录制文件存储格式。

4. （可选）构造音频属性AudioProperty对象（不设置音频则是只录视频），并调用Recorder实例的setAudioProperty(AudioProperty property)方法，设置录制的音频属性，代码示例如下：

AudioProperty audioProperty = new AudioProperty.Builder()
                    .setRecorderNumChannels(2)
                    .setRecorderSamplingRate(192000)
                    .setRecorderAudioEncoder(Recorder.AudioEncoder.AAC)
                    .setRecorderBitRate(48000)
                    .build();
recorder.setAudioProperty(audioProperty);

5. 构造存储属性StorageProperty对象，并调用Recorder实例的setStorageProperty(StorageProperty property)方法，设置录制的存储属性，代码示例如下

String path = "/sdcard/audiotestRecord.mp4";
StorageProperty storageProperty = new StorageProperty.Builder()
                    .setRecorderPath(path)
                    .setRecorderMaxDurationMs(1000000) 
                    .setRecorderMaxFileSizeBytes(1000000) 
                    .build();
recorder.setStorageProperty(storageProperty);

6. （可选）构造视频属性VideoProperty对象，并调用Recorder实例的setVideoProperty(VideoProperty property)方法，设置录制的视频属性，代码示例如下：

VideoProperty videoProperty = new VideoProperty.Builder()
                    .setRecorderVideoEncoder(Recorder.VideoEncoder.H264)
                    .setRecorderWidth(3840)
                    .setRecorderDegrees(90)
                    .setRecorderHeight(2160)
                    .setRecorderBitRate(40000000)
                    .setRecorderRate(30)
                    .setRecorderFps(30)
                    .build();
recorder.setVideoProperty(videoProperty);
recorder.prepare();

7. 调用prepare()，准备录制。

8. （可选）构造录制回调，首先构造对象IRecorderListener，IRecorderListener需要实现onError(int what, int extra)，实现录制过程收到错误信息时做相应的操作。下面的代码例子中录制异常时，打印了相关的日志信息，代码示例如下：

private HiLogLabel TAG = new HiLogLabel(HiLog.DEBUG, 0xD000500, "MainAblityTest");
class RecorderErrorAndInfoListener implements IRecorderListener {
    @Override
    public void onError(int what, int extra) {
    }

    @Override
    public void onMessage(int what, int extra) {
    }
}
IRecorderListener listener = new RecorderErrorAndInfoListener() {
    @Override
    public void onError(int what, int extra) {
        HiLog.error(TAG, "EncodeWriteFileListener onError what:%{public}d, extra:%{public}d", what, extra);
    }
}

9. 调用start()方法，开始录制。

10. （可选）调用pause()方法和resume()方法，可以实现暂停和恢复录制。

11. 调用 stop()方法停止录制。

12. 录制结束后，调用release()释放资源。

媒体提取开发

场景介绍

媒体提取主要工作是将多媒体文件中的音视频数据进行分离，提取出音频、视频数据源。

接口说明

视频提取类Extractor的主要接口

接口名	功能描述
Extractor()	创建Extractor实例。
setSource(Source source)	设置媒体播放源。
getStreamFormat(int id)	获取对应索引的轨道数据的格式。
getTotalStreams()	获取媒体文件中总轨道数。
specifyStream(int id)	根据轨道号选择媒体文件中对应的轨道。
unspecifyStream(int id)	取消轨道选择。
rewindTo(long microseconds, int mode)	根据时间和mode跳转到指定帧。
next()	跳转到下一帧。
readBuffer(ByteBuffer buf, int offset)	读取解复用后的数据。
getStreamId()	获取当前轨道号。
getFrameTimestamp()	获取当前媒体数据帧的时间戳。
getFrameSize()	获取当前媒体数据帧的数据大小。
getFrameType()	获取当前媒体数据帧的flags。
release()	释放资源。

开发步骤

1. 调用Extractor()方法创建Extractor实例。

2. 构造数据源对象，并调用Extractor实例的setSource(Source source)方法，设置媒体源，代码示例如下：

Extractor extractor = new Extractor();
File file = new File("/sdcard/test_audio.mp4"); // 根据实际情况设置文件路径
FileInputStream in = new FileInputStream(file);
FileDescriptor fd = in.getFD();
Source source = new Source(fd);
extractor.setSource(source);

3. 调用getTotalStreams()方法获取媒体的轨道数量。

4. 调用specifyStream(int id)方法选择特定轨道的数据，进行提取。

5. （可选）调用unspecifyStream(int id)方法取消选择轨道。

6. （可选）调用rewindTo(long microseconds, int mode)方法实现提取过程中的跳转指定位置。

7. 调用readBuffer(ByteBuffer buf, int offset)方法，可以实现获取提取出来的Buffer数据功能。

8. 调用next()方法，实现提取下一帧的功能。

9. （可选）调用getStreamId()方法，可以实现获取当前选择的轨道编号的功能。

10. （可选）调用getFrameTimestamp()方法，可以实现获取当前轨道内媒体数据帧时间戳的功能。

11. （可选）调用getFrameSize()方法，可以实现获取当前轨道的媒体数据帧大小的功能。

12.（可选）调用getFrameType()方法，可以实现获取当前轨道的媒体数据帧flags的功能。

提取结束后，调用release()释放资源。

HarmonyOSラーニングロードの開発 - マルチメディア開発（ビデオ開発2）

ビデオプレーヤーの開発

シーン紹介

インターフェースの説明

開発ステップ

ビデオ録画開発

シーン紹介

インターフェースの説明

开发步骤

媒体提取开发

场景介绍

接口说明

开发步骤

おすすめ