ドキュメントセンター
edit-icon download-icon

HLS基本インターフェース

最終更新日: Mar 13, 2018

OSS MEDIA C SDK クライアントは、受信した H.264 または AAC 形式のデータを TS または M3U8 形式にパックし、OSS にデータを書き込めます。対応する M3U8 アドレスで、ビデオを表示し、オーディオの聴くことができます。

インターフェース

HLS 関連の基本インターフェースはすべて oss_media_hls.h にあります。現在提供されているインターフェイスは次のとおりです。

  • oss_media_hls_open
  • oss_media_hls_write_frame
  • oss_media_hls_begin_m3u8
  • oss_media_hls_write_m3u8
  • oss_media_hls_end_m3u8
  • oss_media_hls_flush
  • oss_media_hls_close

各インターフェースの使用法と注意事項は次のとおりです。

基本構造

  1. /**
  2.  *  OSS MEDIA HLS FRAME metadata
  3.  */
  4. typedef struct oss_media_hls_frame_s {
  5.     stream_type_t stream_type;
  6.     frame_type_t frame_type;
  7.     uint64_t pts;
  8.     uint64_t dts;
  9.     uint32_t continuity_counter;
  10.     uint8_t  key:1;
  11.     uint8_t *pos;
  12.     uint8_t *end;
  13. } oss_media_hls_frame_t;
  15. /**
  16.  *  OSS MEDIA HLS descriptive information
  17.  */
  18. typedef struct oss_media_hls_options_s {
  19.     uint16_t video_pid;
  20.     uint16_t audio_pid;
  21.     uint32_t hls_delay_ms;
  22.     uint8_t encrypt:1;
  23.     char    key[OSS_MEDIA_HLS_ENCRYPT_KEY_SIZE];
  24.     file_handler_fn_t handler_func;
  25.     uint16_t pat_interval_frame_count;
  26. } oss_media_hls_options_t;
  28. /**
  29.  *  OSS MEDIA HLS FILE descriptive information
  30.  */
  31. typedef struct oss_media_hls_file_s {
  32.     oss_media_file_t *file;
  33.     oss_media_hls_buf_t *buffer;
  34.     oss_media_hls_options_t options;
  35.     int64_t frame_count;
  36. } oss_media_hls_file_t;
  • stream_type: ストリームタイプ。現在、st_h264 および st_aac タイプがサポートされています。
  • frame_type: フレームタイプ。現在、ft_non_idr、ft_idr、ft_sei、ft_sps、ft_pps、ft_aud がサポートされています。
  • pts: 表示タイムスタンプ。
  • dts: デコードタイムスタンプ。
  • continuity_counter: インクリメンタルカウンタ。値の範囲は0〜15ですが、開始値は必ずしも0ではありません。値は連続していなければなりません。
  • key: キーフレームであるかどうか。
  • pos: 現在のフレームデータの開始位置（両端を含む）。
  • end: 現在のフレームデータの終了位置（排他）。
  • video_pid: ビデオPID。
  • audio_pid: オーディオPID。
  • hls_delay_ms: 表示レイテンシ（ミリ秒）。
  • encrypt: AES-128 暗号化を使用するかどうか。現在、AES-128 暗号化はサポートされていません。
  • key: 暗号化が有効な場合のキー。現在、この機能はサポートされていません。
  • handler_func: オブジェクト操作のコールバック関数。
  • pat_interval_frame_count: 挿入された2つのPATまたは挿入された 2 つMATテーブル間のフレーム数。

HLS ファイルを開く

  1. /**
  2.  *  @brief  Open an OSS HLS file
  3.  *  @param[in]  Name of the bucket that stores objects in bucket_name oss
  4.  *  @param[in]  Name of the object in object_key oss
  5.  *  @param[in]  auth_func  The authorization function to set access_key_id/access_key_secret
  6.  *  @return:
  7.  *      If NULL is returned, it indicates success. Otherwise, it indicates failure.
  8.  */
  9. oss_media_hls_file_t* oss_media_hls_open(char *bucket_name, char *object_key, auth_fn_t auth_func);

注意: サンプルコードは GitHubで見つけることができます。

HLS ファイルを閉じる

  1. /**
  2.  *  @brief  Close the OSS HLS file
  3.  */
  4. int oss_media_hls_close(oss_media_hls_file_t *file);

注意:サンプルコードは GitHub で見つけることができます。

HLS ファイルを書く

  1. /**
  2.  *  @brief  Write a frame of data in H.264 or AAC format to the OSS
  3.  *  @param[in]  frame         A frame of data in H.264 or AAC format
  4.  *  @param[out] file          HLS file
  5.  *  @return:
  6.  *      If 0 is returned, it indicates the operation is successful.
  7.  *      Otherwise, it indicates an error has occured
  8.  */
  9. int oss_media_hls_write_frame(oss_media_hls_frame_t *frame, oss_media_hls_file_t *file);

サンプルプロジェクト:

  1. static void write_frame(oss_media_hls_file_t *file) {
  2.     oss_media_hls_frame_t frame;
  3.     FILE    *file_h264;
  4.     uint8_t *buf_h264;
  5.     int     len_h264, i;
  6.     int     cur_pos = -1;
  7.     int     last_pos = -1;
  8.     int     video_frame_rate = 30;
  9.     int     max_size = 10 * 1024 * 1024;
  10.     char    *h264_file_name = "/path/to/example.h264";
  12.     /* Read the H.264 file */
  13.     buf_h264 = calloc(max_size, 1);
  14.     file_h264 = fopen(h264_file_name, "r");
  15.     len_h264 = fread(buf_h264, 1, max_size, file_h264);
  17.     /* Initialize the frame struct */
  18.     frame.stream_type = st_h264;
  19.     frame.pts = 0;
  20.     frame.continuity_counter = 1;
  21.     frame.key = 1;
  23.     /* Tranverse the H.264 data and extract the data of every frame, and then write the data into the OSS */
  24.     for (i = 0; i < len_h264; i++) {
  25.         /*  Determine whether the current location is the starting point of the data of the next frame, that is, the end of the current frame */
  26.         if ((buf_h264[i] & 0x0F)==0x00 && buf_h264[i+1]==0x00 
  27.             && buf_h264[i+2]==0x00 && buf_h264[i+3]==0x01) 
  28.         {
  29.             cur_pos = i;
  30.         }
  32.     /* If the data of a complete frame can be obtained, call the interface to convert the data into the HLS format and write the data into the OSS */
  33.         if (last_pos != -1 && cur_pos > last_pos) {
  34.             frame.pts += 90000 / video_frame_rate;
  35.             frame.dts = frame.pts;
  37.             frame.pos = buf_h264 + last_pos;
  38.             frame.end = buf_h264 + cur_pos;
  40.             oss_media_hls_write_frame(&frame, file);
  41.         }
  43.         last_pos = cur_pos;
  44.     }
  46.     /* Close the object and release the resource */
  47.     fclose(file_h264);
  48.     free(buf_h264);
  49. }

注意:

  • サンプルコードは GitHub で見つけることができます。
  • H.264 データに Access Unit Delimiter NAL（00 00 00 01 09 xx） がない場合、この NAL が必要です。それ以外の場合は、iPad、iPhone、Safari でオーディオやビデオを再生できません。
  • H.264 フレームは、0xX0、0x00、0x00、0x01 で区切られます。 AAC フレームは 0xFF と 0x0X で区切られます。
  • 現在のフレームがキーフレームの場合、frame.key を 1 に設定する必要があります。

M3U8 オブジェクトを書く

  1. /**
  2.  *  @brief  Write the header data of the M3U8 object
  3.  *  @param[in]  max_duration  The maximum duration of the TS object
  4.  *  @param[in]  sequence      The starting number of the TS object
  5.  *  @param[out] file          M3U8 file
  6.  *  @return:
  7.  *      If 0 is returned, it indicates the operation was successful.
  8.  *      Otherwise, if "-1" is returned, it indicates an error has occurred. 
  9.  */
  10. void oss_media_hls_begin_m3u8(int32_t max_duration, 
  11.                               int32_t sequence,
  12.                               oss_media_hls_file_t *file);
  14. /**
  15.  *  @brief  Write the data of the M3U8 object
  16.  *  @param[in]  size          Number of the M3U8 items
  17.  *  @param[in]  m3u8          Details of the M3u8 item
  18.  *  @param[out] file          M3U8 file
  19.  *  @return:
  20.  *      If 0 is returned, it indicates the operation is successful.
  21.  *      Otherwise, if "-1" is returned, it indicates an error has occured.
  22.  */
  23. int oss_media_hls_write_m3u8(int size,
  24.                              oss_media_hls_m3u8_info_t m3u8[],
  25.                              oss_media_hls_file_t *file);
  27. /**
  28.  *  @brief  Write data such as the M3U8 object terminator
  29.  *  @param[out] file          M3U8 file
  30.  */
  31. void oss_media_hls_end_m3u8(oss_media_hls_file_t *file);

サンプルプロジェクト:

  1. static void write_m3u8() {
  2.     char *bucket_name;
  3.     char *key;
  4.     oss_media_hls_file_t *file;
  6.     bucket_name = "<your bucket name>";
  7.     key = "<your m3u8 file name>";
  9.     /* Open an HLS object to write the M3U8-format data. The object name must end with ".m3u8" */
  10.     file = oss_media_hls_open(bucket_name, key, auth_func);
  11.     if (file == NULL) {
  12.         printf("open m3u8 file[%s] failed.", key);
  13.         return;
  14.     }
  16.     /* Construct the information of three TS objects */
  17.     oss_media_hls_m3u8_info_t m3u8[3];
  18.     m3u8[0].duration = 9;
  19.     memcpy(m3u8[0].url, "video-0.ts", strlen("video-0.ts"));
  20.     m3u8[1].duration = 10;
  21.     memcpy(m3u8[1].url, "video-1.ts", strlen("video-1.ts"));
  23.     /* Write to the M3U8 object
  24.     oss_media_hls_begin_m3u8(10, 0, file);
  25.     oss_media_hls_write_m3u8(2, m3u8, file);
  26.     oss_media_hls_end_m3u8(file);
  28.     /* Close the HLS object */
  29.     oss_media_hls_close(file);
  31.     printf("write m3u8 to oss file succeeded\n");
  32. }

注意:

  • M3U8 V3 が現在使用されています。
  • 録音シナリオでは、録音終了時にターミネータを書き込むために oss_media_hls_end_m3u8 （ファイル）インターフェイスが呼び出されます。それ以外の場合、ビデオは再生できません。ライブビデオシナリオでは、このインターフェイスを呼び出すことはできません。
  • サンプルコードは GitHub で見つけることができます。
  • サンプルプロジェクトでエフェクトを表示できます。
  • ビデオは VLC Player から、iPhone、iPad、Mac デバイスでは Safari 経由で視聴できます。
アカウント登録 コンソール