DASH Media Packaging SDK
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator
packager_util.cc
1 // Copyright 2014 Google Inc. All rights reserved.
2 //
3 // Use of this source code is governed by a BSD-style
4 // license that can be found in the LICENSE file or at
5 // https://developers.google.com/open-source/licenses/bsd
6 
7 #include "packager/app/packager_util.h"
8 
9 #include <gflags/gflags.h>
10 #include <iostream>
11 
12 #include "packager/app/crypto_flags.h"
13 #include "packager/app/fixed_key_encryption_flags.h"
14 #include "packager/app/mpd_flags.h"
15 #include "packager/app/muxer_flags.h"
16 #include "packager/app/playready_key_encryption_flags.h"
17 #include "packager/app/widevine_encryption_flags.h"
18 #include "packager/base/logging.h"
19 #include "packager/base/strings/string_number_conversions.h"
20 #include "packager/media/base/fixed_key_source.h"
21 #include "packager/media/base/media_handler.h"
22 #include "packager/media/base/muxer_options.h"
23 #include "packager/media/base/playready_key_source.h"
24 #include "packager/media/base/request_signer.h"
25 #include "packager/media/base/status.h"
26 #include "packager/media/base/widevine_key_source.h"
27 #include "packager/media/chunking/chunking_handler.h"
28 #include "packager/media/crypto/encryption_handler.h"
29 #include "packager/media/file/file.h"
30 #include "packager/mpd/base/mpd_options.h"
31 
32 DEFINE_bool(mp4_use_decoding_timestamp_in_timeline,
33  false,
34  "If set, decoding timestamp instead of presentation timestamp will "
35  "be used when generating media timeline, e.g. timestamps in sidx "
36  "and mpd. This is to workaround a Chromium bug that decoding "
37  "timestamp is used in buffered range, https://crbug.com/398130.");
38 DEFINE_bool(dump_stream_info, false, "Dump demuxed stream info.");
39 
40 namespace shaka {
41 namespace media {
42 namespace {
43 
44 FourCC GetProtectionScheme(const std::string& protection_scheme) {
45  if (protection_scheme == "cenc") {
46  return FOURCC_cenc;
47  } else if (protection_scheme == "cens") {
48  return FOURCC_cens;
49  } else if (protection_scheme == "cbc1") {
50  return FOURCC_cbc1;
51  } else if (protection_scheme == "cbcs") {
52  return FOURCC_cbcs;
53  } else {
54  LOG(ERROR) << "Unknown protection scheme: " << protection_scheme;
55  return FOURCC_NULL;
56  }
57 }
58 
59 } // namespace
60 
61 std::unique_ptr<RequestSigner> CreateSigner() {
62  std::unique_ptr<RequestSigner> signer;
63 
64  if (!FLAGS_aes_signing_key.empty()) {
65  signer.reset(AesRequestSigner::CreateSigner(
66  FLAGS_signer, FLAGS_aes_signing_key, FLAGS_aes_signing_iv));
67  if (!signer) {
68  LOG(ERROR) << "Cannot create an AES signer object from '"
69  << FLAGS_aes_signing_key << "':'" << FLAGS_aes_signing_iv
70  << "'.";
71  return std::unique_ptr<RequestSigner>();
72  }
73  } else if (!FLAGS_rsa_signing_key_path.empty()) {
74  std::string rsa_private_key;
75  if (!File::ReadFileToString(FLAGS_rsa_signing_key_path.c_str(),
76  &rsa_private_key)) {
77  LOG(ERROR) << "Failed to read from '" << FLAGS_rsa_signing_key_path
78  << "'.";
79  return std::unique_ptr<RequestSigner>();
80  }
81  signer.reset(RsaRequestSigner::CreateSigner(FLAGS_signer, rsa_private_key));
82  if (!signer) {
83  LOG(ERROR) << "Cannot create a RSA signer object from '"
84  << FLAGS_rsa_signing_key_path << "'.";
85  return std::unique_ptr<RequestSigner>();
86  }
87  }
88  return signer;
89 }
90 
91 std::unique_ptr<KeySource> CreateEncryptionKeySource() {
92  std::unique_ptr<KeySource> encryption_key_source;
93  if (FLAGS_enable_widevine_encryption) {
94  std::unique_ptr<WidevineKeySource> widevine_key_source(
95  new WidevineKeySource(FLAGS_key_server_url, FLAGS_include_common_pssh));
96  if (!FLAGS_signer.empty()) {
97  std::unique_ptr<RequestSigner> request_signer(CreateSigner());
98  if (!request_signer)
99  return std::unique_ptr<KeySource>();
100  widevine_key_source->set_signer(std::move(request_signer));
101  }
102 
103  std::vector<uint8_t> content_id;
104  if (!base::HexStringToBytes(FLAGS_content_id, &content_id)) {
105  LOG(ERROR) << "Invalid content_id hex string specified.";
106  return std::unique_ptr<KeySource>();
107  }
108  Status status = widevine_key_source->FetchKeys(content_id, FLAGS_policy);
109  if (!status.ok()) {
110  LOG(ERROR) << "Widevine encryption key source failed to fetch keys: "
111  << status.ToString();
112  return std::unique_ptr<KeySource>();
113  }
114  encryption_key_source = std::move(widevine_key_source);
115  } else if (FLAGS_enable_fixed_key_encryption) {
116  encryption_key_source = FixedKeySource::CreateFromHexStrings(
117  FLAGS_key_id, FLAGS_key, FLAGS_pssh, FLAGS_iv);
118  } else if (FLAGS_enable_playready_encryption) {
119  if (!FLAGS_playready_key_id.empty() && !FLAGS_playready_key.empty()) {
120  encryption_key_source = PlayReadyKeySource::CreateFromKeyAndKeyId(
121  FLAGS_playready_key_id, FLAGS_playready_key);
122  } else if (!FLAGS_playready_server_url.empty() &&
123  !FLAGS_program_identifier.empty()) {
124  std::unique_ptr<PlayReadyKeySource> playready_key_source;
125  if (!FLAGS_client_cert_file.empty() &&
126  !FLAGS_client_cert_private_key_file.empty() &&
127  !FLAGS_client_cert_private_key_password.empty()) {
128  playready_key_source.reset(new PlayReadyKeySource(
129  FLAGS_playready_server_url,
130  FLAGS_client_cert_file,
131  FLAGS_client_cert_private_key_file,
132  FLAGS_client_cert_private_key_password));
133  } else {
134  playready_key_source.reset(new PlayReadyKeySource(
135  FLAGS_playready_server_url));
136  }
137  if (!FLAGS_ca_file.empty()) {
138  playready_key_source->SetCaFile(FLAGS_ca_file);
139  }
140  playready_key_source->FetchKeysWithProgramIdentifier(FLAGS_program_identifier);
141  encryption_key_source = std::move(playready_key_source);
142  } else {
143  LOG(ERROR) << "Error creating PlayReady key source.";
144  return std::unique_ptr<KeySource>();
145  }
146  }
147  return encryption_key_source;
148 }
149 
150 std::unique_ptr<KeySource> CreateDecryptionKeySource() {
151  std::unique_ptr<KeySource> decryption_key_source;
152  if (FLAGS_enable_widevine_decryption) {
153  std::unique_ptr<WidevineKeySource> widevine_key_source(
154  new WidevineKeySource(FLAGS_key_server_url, FLAGS_include_common_pssh));
155  if (!FLAGS_signer.empty()) {
156  std::unique_ptr<RequestSigner> request_signer(CreateSigner());
157  if (!request_signer)
158  return std::unique_ptr<KeySource>();
159  widevine_key_source->set_signer(std::move(request_signer));
160  }
161 
162  decryption_key_source = std::move(widevine_key_source);
163  } else if (FLAGS_enable_fixed_key_decryption) {
164  const char kNoPssh[] = "";
165  const char kNoIv[] = "";
166  decryption_key_source = FixedKeySource::CreateFromHexStrings(
167  FLAGS_key_id, FLAGS_key, kNoPssh, kNoIv);
168  }
169  return decryption_key_source;
170 }
171 
172 ChunkingOptions GetChunkingOptions() {
173  ChunkingOptions chunking_options;
174  chunking_options.segment_duration_in_seconds = FLAGS_segment_duration;
175  chunking_options.subsegment_duration_in_seconds = FLAGS_fragment_duration;
176  chunking_options.segment_sap_aligned = FLAGS_segment_sap_aligned;
177  chunking_options.subsegment_sap_aligned = FLAGS_fragment_sap_aligned;
178  return chunking_options;
179 }
180 
181 EncryptionOptions GetEncryptionOptions() {
182  EncryptionOptions encryption_options;
183  encryption_options.clear_lead_in_seconds = FLAGS_clear_lead;
184  encryption_options.protection_scheme =
185  GetProtectionScheme(FLAGS_protection_scheme);
186  encryption_options.max_sd_pixels = FLAGS_max_sd_pixels;
187  encryption_options.max_hd_pixels = FLAGS_max_hd_pixels;
188  encryption_options.max_uhd1_pixels = FLAGS_max_uhd1_pixels;
189  encryption_options.crypto_period_duration_in_seconds =
190  FLAGS_crypto_period_duration;
191  encryption_options.vp9_subsample_encryption = FLAGS_vp9_subsample_encryption;
192  return encryption_options;
193 }
194 
195 MuxerOptions GetMuxerOptions() {
196  MuxerOptions muxer_options;
197  muxer_options.num_subsegments_per_sidx = FLAGS_num_subsegments_per_sidx;
198  muxer_options.mp4_include_pssh_in_stream = FLAGS_mp4_include_pssh_in_stream;
199  if (FLAGS_mp4_use_decoding_timestamp_in_timeline) {
200  LOG(WARNING) << "Flag --mp4_use_decoding_timestamp_in_timeline is set. "
201  "Note that it is a temporary hack to workaround Chromium "
202  "bug https://crbug.com/398130. The flag may be removed "
203  "when the Chromium bug is fixed.";
204  }
205  muxer_options.mp4_use_decoding_timestamp_in_timeline =
206  FLAGS_mp4_use_decoding_timestamp_in_timeline;
207  muxer_options.temp_dir = FLAGS_temp_dir;
208  return muxer_options;
209 }
210 
211 MpdOptions GetMpdOptions(bool on_demand_profile) {
212  MpdOptions mpd_options;
213  mpd_options.dash_profile =
214  on_demand_profile ? DashProfile::kOnDemand : DashProfile::kLive;
215  mpd_options.mpd_type = (on_demand_profile || FLAGS_generate_static_mpd)
216  ? MpdType::kStatic
217  : MpdType::kDynamic;
218  mpd_options.availability_time_offset = FLAGS_availability_time_offset;
219  mpd_options.minimum_update_period = FLAGS_minimum_update_period;
220  mpd_options.min_buffer_time = FLAGS_min_buffer_time;
221  mpd_options.time_shift_buffer_depth = FLAGS_time_shift_buffer_depth;
222  mpd_options.suggested_presentation_delay = FLAGS_suggested_presentation_delay;
223  mpd_options.default_language = FLAGS_default_language;
224  return mpd_options;
225 }
226 
227 Status ConnectHandlers(std::vector<std::shared_ptr<MediaHandler>>& handlers) {
228  size_t num_handlers = handlers.size();
229  Status status;
230  for (size_t i = 1; i < num_handlers; ++i) {
231  status.Update(handlers[i - 1]->AddHandler(handlers[i]));
232  }
233  return status;
234 }
235 
236 } // namespace media
237 } // namespace shaka
static RsaRequestSigner * CreateSigner(const std::string &signer_name, const std::string &pkcs1_rsa_key)
static AesRequestSigner * CreateSigner(const std::string &signer_name, const std::string &aes_key_hex, const std::string &iv_hex)
void Update(const Status &new_status)
Definition: status.h:130
static std::unique_ptr< FixedKeySource > CreateFromHexStrings(const std::string &key_id_hex, const std::string &key_hex, const std::string &pssh_boxes_hex, const std::string &iv_hex)
void SetCaFile(const std::string &ca_file)
Sets the Certificate Authority file for validating self-signed certificates.
double clear_lead_in_seconds
Clear lead duration in seconds.
double segment_duration_in_seconds
Segment duration in seconds.
static bool ReadFileToString(const char *file_name, std::string *contents)
Definition: file.cc:185
static std::unique_ptr< PlayReadyKeySource > CreateFromKeyAndKeyId(const std::string &key_id_hex, const std::string &key_hex)