Gotwilio 库技术文档

1. 安装指南

安装 Gotwilio 非常简单。您只需在命令行中运行以下命令：

go get github.com/sfreiberg/gotwilio

这条命令将会自动下载并安装 Gotwilio 库到您的 Go 工作空间。

2. 项目的使用说明

Gotwilio 库支持通过 Twilio 服务进行语音呼叫、发送短信（SMS）和彩信（MMS），以及创建视频房间。以下是一些基本的使用示例：

发送短信

package main

import (
    "github.com/sfreiberg/gotwilio"
)

func main() {
    accountSid := "您的Account SID"
    authToken := "您的Auth Token"
    twilio := gotwilio.NewTwilioClient(accountSid, authToken)

    from := "+发送者电话号码"
    to := "+接收者电话号码"
    message := "欢迎使用gotwilio!"
    twilio.SendSMS(from, to, message, "", "")
}

发送彩信

package main

import (
    "github.com/sfreiberg/gotwilio"
)

func main() {
    accountSid := "您的Account SID"
    authToken := "您的Auth Token"
    twilio := gotwilio.NewTwilioClient(accountSid, authToken)

    from := "+发送者电话号码"
    to := "+接收者电话号码"
    message := "欢迎使用gotwilio!"
    mediaUrl := []string{"http://您的图片链接"}
    twilio.SendMMS(from, to, message, mediaUrl, "", "")
}

语音呼叫

package main

import (
    "github.com/sfreiberg/gotwilio"
)

func main() {
    accountSid := "您的Account SID"
    authToken := "您的Auth Token"
    twilio := gotwilio.NewTwilioClient(accountSid, authToken)

    from := "+发送者电话号码"
    to := "+接收者电话号码"
    callbackParams := gotwilio.NewCallbackParameters("http://您的回调地址")
    twilio.CallWithUrlCallbacks(from, to, callbackParams)
}

创建视频房间

package main

import (
    "github.com/sfreiberg/gotwilio"
)

func main() {
    accountSid := "您的Account SID"
    authToken := "您的Auth Token"
    twilio := gotwilio.NewTwilioClient(accountSid, authToken)

    twilio.CreateVideoRoom(gotwilio.DefaultVideoRoomOptions)
}

确保替换示例中的 Account SID、Auth Token、电话号码和链接等占位符为您的实际信息。

3. 项目API使用文档

Gotwilio 提供了以下API功能：

• NewTwilioClient(accountSid, authToken string)：创建 Twilio 客户端实例。
• SendSMS(from, to, message, mediaUrl string, statusCallback string)：发送短信。
• SendMMS(from, to, message, mediaUrls []string, statusCallback string)：发送彩信。
• CallWithUrlCallbacks(from, to string, params *CallbackParameters)：进行语音呼叫。
• CreateVideoRoom(options VideoRoomOptions)：创建视频房间。

4. 项目安装方式

项目的安装方式已在“安装指南”一节中描述，概括如下：

使用 go get 命令，您可以快速安装 Gotwilio 库：

go get github.com/sfreiberg/gotwilio