go-eventsocket 项目使用教程

1. 项目目录结构及介绍

go-eventsocket 项目是一个用 Go 语言编写的 FreeSWITCH Event Socket 库。项目的目录结构如下：

.
├── .gitignore
├── examples
│   ├── client.go
│   └── server.go
├── eventsocket
│   └── eventsocket.go
├── LICENSE
└── README.md

• .gitignore：Git 忽略文件，指定 Git 在提交时应该忽略的文件和目录。
• examples：示例代码目录，包含如何使用 go-eventsocket 的示例。
  • client.go：客户端示例，演示如何连接到 FreeSWITCH 并发起呼叫。
  • server.go：服务器端示例，演示如何接收 FreeSWITCH 的连接并处理事件。
• eventsocket：库代码目录，包含 go-eventsocket 的核心实现。
  • eventsocket.go：实现 Event Socket 连接和事件处理的主要文件。
• LICENSE：项目许可证文件，本项目采用开源许可证。
• README.md：项目说明文件，介绍项目的相关信息和使用说明。

2. 项目的启动文件介绍

项目的启动文件位于 examples 目录下，分为客户端和服务端两个示例。

客户端启动文件（client.go）

客户端代码用于连接到 FreeSWITCH Event Socket 服务器，并可以发起呼叫。使用方法如下：

// 导入相关包
package main

import (
    "fmt"
    "log"
    "github.com/fiorix/go-eventsocket/eventsocket"
)

func main() {
    // 创建 Event Socket 客户端
    c, err := eventsocket.Dial("tcp", "localhost:8081")
    if err != nil {
        log.Fatal(err)
    }
    defer c.Close()

    // 发送命令到 FreeSWITCH
    if err := c.Send("api login mypassword"); err != nil {
        log.Fatal(err)
    }

    // 读取响应
    response, err := c.Recv()
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("Response:", response)

    // 发起呼叫
    if err := c.Send("api originate sip/myuser &play(file=/path/to/file.wav)"); err != nil {
        log.Fatal(err)
    }

    // 处理更多逻辑...
}

服务端启动文件（server.go）

服务端代码用于监听 FreeSWITCH Event Socket 的连接请求，并处理相关事件。使用方法如下：

// 导入相关包
package main

import (
    "fmt"
    "log"
    "net"
    "github.com/fiorix/go-eventsocket/eventsocket"
)

func main() {
    // 监听 Event Socket 端口
    ln, err := net.Listen("tcp", ":8081")
    if err != nil {
        log.Fatal(err)
    }
    defer ln.Close()

    for {
        // 接受新的连接
        conn, err := ln.Accept()
        if err != nil {
            log.Println(err)
            continue
        }

        // 处理连接
        go handleConnection(conn)
    }
}

func handleConnection(conn net.Conn) {
    // 创建 Event Socket 连接
    c := eventsocket.New(conn)

    // 处理事件
    for {
        // 读取事件
        e, err := c.Recv()
        if err != nil {
            log.Println(err)
            break
        }

        // 处理事件
        fmt.Println("Event:", e)
        // 发送响应
        if err := c.Send(fmt.Sprintf("reply %d", e.ID)); err != nil {
            log.Println(err)
            break
        }
    }
}

3. 项目的配置文件介绍

本项目没有专门的配置文件。所有的配置，如连接地址、端口、密码等，都应该在代码中直接硬编码或通过环境变量来配置。这样做可以简化部署和配置过程，但可能不适用于所有生产环境。如果需要配置文件，可以通过标准库 encoding/json、gopkg.in/yaml.v2 或其他库来读取 JSON、YAML 等格式的配置文件。