1/*
2 * Copyright (C) 2010 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef A_SESSION_DESCRIPTION_H_
18
19#define A_SESSION_DESCRIPTION_H_
20
21#include <sys/types.h>
22
23#include <media/stagefright/foundation/ABase.h>
24#include <utils/KeyedVector.h>
25#include <utils/RefBase.h>
26#include <utils/Vector.h>
27
28namespace android {
29
30struct AString;
31
32struct ASessionDescription : public RefBase {
33    ASessionDescription();
34
35    bool setTo(const void *data, size_t size);
36    bool isValid() const;
37
38    // Actually, 1 + number of tracks, as index 0 is reserved for the
39    // session description root-level attributes.
40    size_t countTracks() const;
41    void getFormat(size_t index, AString *value) const;
42
43    void getFormatType(
44            size_t index, unsigned long *PT,
45            AString *desc, AString *params) const;
46
47    bool getDimensions(
48            size_t index, unsigned long PT,
49            int32_t *width, int32_t *height) const;
50
51    bool getDurationUs(int64_t *durationUs) const;
52
53    static void ParseFormatDesc(
54            const char *desc, int32_t *timescale, int32_t *numChannels);
55
56    bool findAttribute(size_t index, const char *key, AString *value) const;
57
58    // parses strings of the form
59    //   npt      := npt-time "-" npt-time? | "-" npt-time
60    //   npt-time := "now" | [0-9]+("." [0-9]*)?
61    //
62    // Returns true iff both "npt1" and "npt2" times were available,
63    // i.e. we have a fixed duration, otherwise this is live streaming.
64    static bool parseNTPRange(const char *s, float *npt1, float *npt2);
65
66protected:
67    virtual ~ASessionDescription();
68
69private:
70    typedef KeyedVector<AString,AString> Attribs;
71
72    bool mIsValid;
73    Vector<Attribs> mTracks;
74    Vector<AString> mFormats;
75
76    bool parse(const void *data, size_t size);
77
78    DISALLOW_EVIL_CONSTRUCTORS(ASessionDescription);
79};
80
81}  // namespace android
82
83#endif  // A_SESSION_DESCRIPTION_H_
84