Add helper functions for negotiating H264 profile level id

webrtc/common_video/h264/profile_level_id.h

 /*
  *  Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
  *
  *  Use of this source code is governed by a BSD-style license
  *  that can be found in the LICENSE file in the root of the source
  *  tree. An additional intellectual property rights grant can be found
  *  in the file PATENTS.  All contributing project authors may
  *  be found in the AUTHORS file in the root of the source tree.
  */
 
 #ifndef WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_
 #define WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_
 
+#include <map>
 #include <string>
 
 #include "webrtc/base/optional.h"
 
 namespace webrtc {
 namespace H264 {
 
+// Map containting SDP codec parameters.
+typedef std::map<std::string, std::string> CodecParameterMap;
+
 enum Profile {
   kProfileConstrainedBaseline,
   kProfileBaseline,
   kProfileMain,
   kProfileConstrainedHigh,
   kProfileHigh,
 };
 
 // All values are equal to ten times the level number, except level 1b which is
 // special.
@@ skipping 22 matching lines @@
       : profile(profile), level(level) {}
   Profile profile;
   Level level;
 };
 
 // Parse profile level id that is represented as a string of 3 hex bytes.
 // Nothing will be returned if the string is not a recognized H264
 // profile level id.
 rtc::Optional<ProfileLevelId> ParseProfileLevelId(const char* str);
 
+// Parse profile level id that is represented as a string of 3 hex bytes
+// contained in an SDP key-value map. A default profile level id will be
+// returned if the profile-level-id key is missing. Nothing will be returned if
+// the key is present but the string is invalid.
+rtc::Optional<ProfileLevelId> ParseSdpProfileLevelId(
+    const CodecParameterMap& params);
+
 // Returns canonical string representation as three hex bytes of the profile
 // level id, or returns nothing for invalid profile level ids.
 rtc::Optional<std::string> ProfileLevelIdToString(
     const ProfileLevelId& profile_level_id);
 
+// Return negotiated profile level id based on local and remote codec
+// parameters profile-level-id and level-asymmetry-allowed. Return nothing if
+// the parameters are not compatible.
+rtc::Optional<ProfileLevelId> NegotiateProfileLevelId(
+    const CodecParameterMap& local_params,
+    const CodecParameterMap& remote_params);
+
 }  // namespace H264
 }  // namespace webrtc
 
 #endif  // WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_