Golang HLS Streamer 项目使用教程

Golang HLS Streamer 项目使用教程

gohls A server that exposes a directory for video streaming via web interface 项目地址: https://gitcode.com/gh_mirrors/go/gohls

1. 项目的目录结构及介绍

Golang HLS Streamer项目的目录结构如下：

gohls/
├── .github/             # GitHub 工作流文件
│   └── workflows/
├── ui/                  # 前端代码目录
│   ├── node_modules/
│   ├── build/
│   ├── src/
│   └── package.json
├── scripts/             # 脚本目录
├── internal/            # 内部工具和库
├── .gitignore           # Git 忽略文件
├── LICENSE.txt          # 许可证文件
├── NOTES.txt            # 项目说明文件
├── README.md            # 项目说明文档
├── _config.yml          # 配置文件模板
├── example-config.json  # 配置文件示例
├── go.mod               # Go 模块文件
├── go.sum               # Go 依赖校验文件
└── main.go              # 项目主入口文件

• .github/: 存放GitHub Actions工作流文件，用于自动化项目的一些操作，如测试、构建等。
• ui/: 前端代码目录，通常包含HTML、CSS和JavaScript等文件。
• scripts/: 存放项目的脚本文件，用于启动服务、构建项目等。
• internal/: 包含项目内部使用的工具和库。
• .gitignore: 指定Git应该忽略的文件和目录。
• LICENSE.txt: 项目的许可证信息。
• NOTES.txt: 项目的一些重要说明。
• README.md: 项目的详细说明文档。
• _config.yml: 配置文件模板，可以根据实际情况修改。
• example-config.json: 配置文件示例，用于指导用户如何创建自己的配置文件。
• go.mod: Go项目的依赖管理文件。
• go.sum: 校验Go依赖的文件。
• main.go: 项目的主入口文件，负责启动服务。

2. 项目的启动文件介绍

项目的启动文件是main.go，它负责初始化并启动HTTP服务。以下是main.go的主要部分：

package main

import (
    "flag"
    "log"
    "net/http"
    "os"
)

func main() {
    // 解析命令行参数
    configPath := flag.String("config", "gohls-config.json", "配置文件路径")
    flag.Parse()

    // 读取配置文件
    config, err := ReadConfig(*configPath)
    if err != nil {
        log.Fatal("无法读取配置文件: ", err)
    }

    // 设置HTTP服务路由
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        // 处理请求
    })

    // 启动HTTP服务
    log.Printf("Starting server on port %d...\n", config.Port)
    err = http.ListenAndServe(":"+config.Port, nil)
    if err != nil {
        log.Fatal("无法启动服务: ", err)
    }
}

在main.go中，首先解析命令行参数，然后读取配置文件，设置HTTP服务路由，并启动服务。

3. 项目的配置文件介绍

项目的配置文件是一个JSON格式的文件，用于指定视频目录和服务器设置。配置文件可以命名为gohls-config.json或其他任意名称，但必须遵循以下格式：

{
    "folders": [
        {
            "path": "~/Videos",
            "title": "我的视频"
        },
        {
            "path": "~/Downloads",
            "title": "我的下载"
        }
    ],
    "port": "8080"
}

• folders: 一个数组，包含要暴露的目录信息。每个对象包含path和title字段，path是视频目录的路径，title是在Web界面中显示的目录标题。
• port: 服务器监听的端口，默认为8080。

gohls A server that exposes a directory for video streaming via web interface 项目地址: https://gitcode.com/gh_mirrors/go/gohls