For #299, extract fragment and fragment window for hls

trunk/src/app/srs_app_fragment.hpp

@@ -0,0 +1,110 @@
+/*
+The MIT License (MIT)
+
+Copyright (c) 2013-2017 SRS(ossrs)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+*/
+
+#ifndef SRS_APP_FRAGMENT_HPP
+#define SRS_APP_FRAGMENT_HPP
+
+/*
+#include <srs_app_fragment.hpp>
+*/
+#include <srs_core.hpp>
+
+#include <string>
+#include <vector>
+
+/**
+ * Represent a fragment, such as HLS segment, DVR segment or DASH segment.
+ * It's a media file, for example FLV or MP4, with duration.
+ */
+class SrsFragment
+{
+private:
+    // The duration in ms.
+    int64_t dur;
+    // The full file path of fragment.
+    std::string filepath;
+    // The start DTS in ms of segment.
+    int64_t start_dts;
+    // Whether current segement contains sequence header.
+    bool sequence_header;
+public:
+    SrsFragment();
+    virtual ~SrsFragment();
+public:
+    // Append a frame with dts into fragment.
+    // @dts The dts of frame in ms.
+    virtual void append(int64_t dts);
+    // Get the duration of fragment in ms.
+    virtual int64_t duration();
+    // Whether the fragment contains any sequence header.
+    virtual bool is_sequence_header();
+    // Set whether contains sequence header.
+    virtual void set_sequence_header(bool v);
+    // Get the full path of fragment.
+    virtual std::string fullpath();
+    // Set the full path of fragment.
+    virtual void set_path(std::string v);
+    // Unlink the fragment, to delete the file.
+    // @remark Ignore any error.
+    virtual int unlink_file();
+public:
+    // Get the temporary path for file.
+    virtual std::string tmppath();
+    // Unlink the temporary file.
+    virtual int unlink_tmpfile();
+    // Rename the temp file to final file.
+    virtual int rename();
+};
+
+/**
+ * The fragment window manage a series of fragment.
+ */
+class SrsFragmentWindow
+{
+private:
+    std::vector<SrsFragment*> fragments;
+    // The expired fragments, need to be free in future.
+    std::vector<SrsFragment*> expired_fragments;
+public:
+    SrsFragmentWindow();
+    virtual ~SrsFragmentWindow();
+public:
+    // Dispose all fragments, delete the files.
+    virtual void dispose();
+    // Append a new fragment, which is ready to delivery to client.
+    virtual void append(SrsFragment* fragment);
+    // Shrink the window, push the expired fragment to a queue.
+    virtual void shrink(int64_t window);
+    // Clear the expired fragments.
+    virtual void clear_expired(bool delete_files);
+    // Get the max duration in ms of all fragments.
+    virtual int64_t max_duration();
+public:
+    virtual bool empty();
+    virtual SrsFragment* first();
+    virtual int size();
+    virtual SrsFragment* at(int index);
+};
+
+#endif
+