ApsaraVideo VOD:基本機能

再生を開始する前に、prepare メソッドを呼び出してプレーヤーを準備します。サンプルコード：

[self.player prepare];

start メソッドを呼び出して再生を開始します。サンプルコード：

[self.player start];

seekToTime メソッドを呼び出して、特定の時刻から再生を開始します。この機能は、ユーザーがプログレスバーのスライダーをドラッグした場合や、特定の時刻から再生を再開する場合に使用されます。サンプルコード：

// position は再生を開始する時刻（単位：ミリ秒）を示します。seekMode を使用して、正確なシークモードまたは不正確なシークモードを指定します。
// 正確なシークモードを使用します。
[self.player seekToTime:position seekMode:AVP_SEEKMODE_ACCURATE];
// 不正確なシークモードを使用します。
[self.player seekToTime:position seekMode:AVP_SEEKMODE_INACCURATE];

pause メソッドを呼び出して再生を一時停止します。サンプルコード：

[self.player pause];

start メソッドを呼び出して再生を再開します。サンプルコード：

[self.player start];

stop メソッドを呼び出して再生を停止します。サンプルコード：

[self.player stop];

プレーヤーを同期的または非同期的に破棄できます。サンプルコード：

// 同期的にプレーヤーを破棄します。システムが自動的に stop 操作を呼び出します。
[self.player destroy];
// 非同期的にプレーヤーを破棄します。システムが自動的に stop 操作を呼び出します。
[self.player destroyAsync];

プレーヤーのステータスをリッスンできます。onPlayerStatusChanged コールバックのパラメーターは、プレーヤーの現在のステータスを示します。サンプルコード：

- (void)onPlayerStatusChanged:(AliPlayer*)player oldStatus:(AVPStatus)oldStatus newStatus:(AVPStatus)newStatus {
    switch (newStatus) {
    case AVPStatusIdle:{
           // プレーヤーはアイドル状態です。
        }
 break;
        case AVPStatusInitialzed:{
           // プレーヤーは初期化されています。
        }
 break;
        case AVPStatusPrepared:{
           // プレーヤーは準備完了です。
        }
 break;
        case AVPStatusStarted:{
           // プレーヤーはメディアストリームの再生中です。
        }
 break;
case AVPStatusPaused:{
           // 再生は一時停止されています。
        }
 break;
case AVPStatusStopped:{
           // 再生は停止されています。
        }
 break;
case AVPStatusCompletion:{
           // 再生が完了しました。
        }
 break;
case AVPStatusError:{
           // 再生エラーが発生しました。
        }
 break;
        default:
            break;
    }
}

scalingMode インターフェイスを介して実装される、縦横比に合わせたフィット、縦横比に合わせたフィル、およびストレッチの 3 つの表示フィルモードをサポートしています。例：

// ビューに収まるように動画を縮小します。動画の縦横比は維持されます。
self.player.scalingMode = AVP_SCALINGMODE_SCALEASPECTFIT;
// ビューを埋めるように動画を拡大します。動画の縦横比は維持されます。
self.player.scalingMode = AVP_SCALINGMODE_SCALEASPECTFILL;
// ビューを埋めるように動画をストレッチします。動画の縦横比は維持されません。動画とビューの縦横比が異なる場合、画像の歪みが発生する可能性があります。
self.player.scalingMode = AVP_SCALINGMODE_SCALETOFILL;

rotateMode メソッドを呼び出して、動画の回転を調整します。サンプルコード：

// 時計回りに 0° の回転角度を設定します。
self.player.rotateMode = AVP_ROTATE_0;
// 時計回りに 90° の回転角度を設定します。
self.player.rotateMode = AVP_ROTATE_90;
// 時計回りに 180° の回転角度を設定します。
self.player.rotateMode = AVP_ROTATE_180;
// 時計回りに 270° の回転角度を設定します。
self.player.rotateMode = AVP_ROTATE_270;

mirrorMode メソッドを呼び出して、ミラー表示モードを指定します。水平方向のミラー表示、垂直方向のミラー表示、およびミラー表示なしの 3 つがサポートされています。サンプルコード：

// 動画イメージに対してミラー表示を行いません。
self.player.mirrorMode = AVP_MIRRORMODE_NONE;
// 動画イメージに対して水平方向のミラー表示を行います。
self.player.mirrorMode = AVP_MIRRORMODE_HORIZONTAL;
// 動画イメージに対して垂直方向のミラー表示を行います。
self.player.mirrorMode = AVP_MIRRORMODE_VERTICAL;

onCurrentPositionUpdate コールバックで現在の再生位置を照会できます。サンプルコード：

- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
// position パラメーターは現在の再生位置（単位：ミリ秒）を示します。
NSString *position = [NSString stringWithFormat:@"%lld, position"];
}

動画の総再生時間を照会できます。動画が読み込まれた後のみ、再生時間を照会できます。たとえば、onPrepared コールバックが呼び出された後に再生時間を照会できます。（単位：ミリ秒）サンプルコード：

-(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
  switch (eventType) {
    case AVPEventPrepareDone: {
      if (self.player.duration >= 0) {
       NSString *duration  = self.player.duration;
      }
    }
      break;
    default:
      break;
  }
}

onBufferedPositionUpdate コールバックで現在のバッファー位置を照会できます。サンプルコード：

- (void)onBufferedPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    NSString *bufferPosition = position;
}

例：

// 現在の動画レンダリングフレームレートを取得します。戻り値のデータ型は FLOAT です。
[self.player getOption:AVP_OPTION_RENDER_FPS]
// 現在の動画ビットレートを取得します。戻り値のデータ型は FLOAT です。（単位：bit/s）
[self.player getOption:AVP_OPTION_VIDEO_BITRATE]
// 現在の音声ビットレートを取得します。戻り値のデータ型は FLOAT です。（単位：bit/s）
[self.player getOption:AVP_OPTION_AUDIO_BITRATE]
// 現在のネットワークダウンリンクビットレートを取得します。戻り値のデータ型は FLOAT です。（単位：bit/s）
[self.player getOption:AVP_OPTION_DOWNLOAD_BITRATE]

動画のボリュームを最大で元の 2 倍まで変更できます。1 より大きい値を設定するとノイズが発生する場合があります。volume メソッドを呼び出してボリュームを変更します。ボリュームを設定した後、ボリューム情報を照会できます。サンプルコード：

// ボリュームを 0 ～ 2 の実数に設定します。
self.player.volume = 1.0f;
// ボリュームを取得します。
self.player.volume

muted メソッドを呼び出して、再生中の動画をミュートします。サンプルコード：

self.player.muted = YES;

ApsaraVideo Player SDK for iOS を使用すると、rate メソッドを呼び出して再生速度を変更できます。0.5 倍～5 倍の再生速度がサポートされています。再生速度を変更しても、音声のピッチは変わりません。サンプルコード：

// 0.5 倍～5 倍の再生速度がサポートされています。一般的な再生速度は、0.5 倍、1 倍、1.5 倍など、0.5 倍単位の倍率です。
self.player.rate = 1.0f;

ApsaraVideo Player SDK for iOS はループ再生をサポートしています。loop メソッドを呼び出してループ再生を有効化します。この機能は、再生が終了した後に動画を最初から再度再生します。サンプルコード：

self.player.loop = YES;

ループ再生が開始されたときに AVPEventLoopingStart コールバックが返されます。サンプルコード：

- (void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventLoopingStart:
            break;
    }
}