使用 rawg-sdk-go 访问 RAWG 视频游戏数据库 API

RAWG 是一个强大的视频游戏数据库 API，而 rawg-sdk-go 是一个非官方的 Go 语言客户端库，用于方便地与 RAWG API 交互。下面我将介绍如何使用这个库。

安装

首先安装 rawg-sdk-go 库：

go get github.com/Davincible/go-rawg

基本使用

1. 初始化客户端

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	rawg "github.com/Davincible/go-rawg"
)

func main() {
	// 从环境变量获取 API 密钥
	apiKey := os.Getenv("RAWG_API_KEY")
	if apiKey == "" {
		log.Fatal("RAWG_API_KEY environment variable not set")
	}

	// 创建客户端
	client, err := rawg.NewClient(apiKey)
	if err != nil {
		log.Fatalf("Failed to create RAWG client: %v", err)
	}

	// 设置上下文
	ctx := context.Background()

	// 示例调用
	games, err := client.GetGames(ctx, &rawg.GamesOptions{
		PageSize: 5,
	})
	if err != nil {
		log.Fatalf("Failed to get games: %v", err)
	}

	for _, game := range games.Results {
		fmt.Printf("%s (ID: %d)\n", game.Name, game.ID)
	}
}

2. 获取游戏详情

func getGameDetails(client *rawg.Client, ctx context.Context, gameID int) {
	game, err := client.GetGame(ctx, gameID)
	if err != nil {
		log.Printf("Failed to get game details: %v", err)
		return
	}

	fmt.Printf("\nGame Details:\n")
	fmt.Printf("Name: %s\n", game.Name)
	fmt.Printf("Released: %s\n", game.Released)
	fmt.Printf("Rating: %.2f\n", game.Rating)
	fmt.Printf("Metacritic: %d\n", game.Metacritic)
	fmt.Printf("Playtime: %d hours\n", game.Playtime)
	fmt.Printf("Description: %s\n", rawg.StripHTMLTags(game.DescriptionRaw))
}

3. 搜索游戏

func searchGames(client *rawg.Client, ctx context.Context, query string) {
	games, err := client.GetGames(ctx, &rawg.GamesOptions{
		Search:   query,
		PageSize: 3,
	})
	if err != nil {
		log.Printf("Failed to search games: %v", err)
		return
	}

	fmt.Printf("\nSearch Results for '%s':\n", query)
	for _, game := range games.Results {
		fmt.Printf("- %s (ID: %d, Rating: %.2f)\n", game.Name, game.ID, game.Rating)
	}
}

4. 获取游戏截图

func getGameScreenshots(client *rawg.Client, ctx context.Context, gameID int) {
	screenshots, err := client.GetGameScreenshots(ctx, gameID, &rawg.ScreenshotsOptions{
		PageSize: 3,
	})
	if err != nil {
		log.Printf("Failed to get screenshots: %v", err)
		return
	}

	fmt.Printf("\nScreenshots:\n")
	for _, screenshot := range screenshots.Results {
		fmt.Printf("- %s\n", screenshot.Image)
	}
}

完整示例

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	rawg "github.com/Davincible/go-rawg"
)

func main() {
	apiKey := os.Getenv("RAWG_API_KEY")
	if apiKey == "" {
		log.Fatal("RAWG_API_KEY environment variable not set")
	}

	client, err := rawg.NewClient(apiKey)
	if err != nil {
		log.Fatalf("Failed to create RAWG client: %v", err)
	}

	ctx := context.Background()

	// 获取热门游戏
	fmt.Println("Popular Games:")
	games, err := client.GetGames(ctx, &rawg.GamesOptions{
		PageSize: 5,
		Ordering: "-rating",
	})
	if err != nil {
		log.Fatalf("Failed to get games: %v", err)
	}

	for _, game := range games.Results {
		fmt.Printf("%s (ID: %d, Rating: %.2f)\n", game.Name, game.ID, game.Rating)
	}

	// 获取第一个游戏的详情
	if len(games.Results) > 0 {
		getGameDetails(client, ctx, games.Results[0].ID)
		getGameScreenshots(client, ctx, games.Results[0].ID)
	}

	// 搜索游戏
	searchGames(client, ctx, "The Witcher 3")
}

func getGameDetails(client *rawg.Client, ctx context.Context, gameID int) {
	game, err := client.GetGame(ctx, gameID)
	if err != nil {
		log.Printf("Failed to get game details: %v", err)
		return
	}

	fmt.Printf("\nGame Details:\n")
	fmt.Printf("Name: %s\n", game.Name)
	fmt.Printf("Released: %s\n", game.Released)
	fmt.Printf("Rating: %.2f\n", game.Rating)
	fmt.Printf("Metacritic: %d\n", game.Metacritic)
	fmt.Printf("Playtime: %d hours\n", game.Playtime)
	fmt.Printf("Description: %s\n", rawg.StripHTMLTags(game.DescriptionRaw))
}

func getGameScreenshots(client *rawg.Client, ctx context.Context, gameID int) {
	screenshots, err := client.GetGameScreenshots(ctx, gameID, &rawg.ScreenshotsOptions{
		PageSize: 3,
	})
	if err != nil {
		log.Printf("Failed to get screenshots: %v", err)
		return
	}

	fmt.Printf("\nScreenshots:\n")
	for _, screenshot := range screenshots.Results {
		fmt.Printf("- %s\n", screenshot.Image)
	}
}

func searchGames(client *rawg.Client, ctx context.Context, query string) {
	games, err := client.GetGames(ctx, &rawg.GamesOptions{
		Search:   query,
		PageSize: 3,
	})
	if err != nil {
		log.Printf("Failed to search games: %v", err)
		return
	}

	fmt.Printf("\nSearch Results for '%s':\n", query)
	for _, game := range games.Results {
		fmt.Printf("- %s (ID: %d, Rating: %.2f)\n", game.Name, game.ID, game.Rating)
	}
}

其他功能

rawg-sdk-go 还支持许多其他功能，包括：

• 获取游戏系列
• 获取游戏平台
• 获取游戏开发商
• 获取游戏发行商
• 获取游戏类型
• 获取游戏标签
• 分页支持

注意事项

1. 你需要在 RAWG 官网注册获取 API 密钥
2. API 有速率限制，请合理使用
3. 某些高级功能可能需要付费订阅
4. 注意处理错误和上下文取消

这个库提供了对 RAWG API 的全面封装，使得在 Go 中访问游戏数据变得非常简单。