kasperfm/neoblizzy

Battle.net API 的 PHP Laravel 客户端

v1.0.0 2022-05-31 18:53 UTC

This package is not auto-updated.

Last update: 2024-10-03 05:44:25 UTC


README

这是一个用于与暴雪娱乐的 Battle.net API 交互的 Laravel (v8.x 和 9.x) 包。

它目前处于一个非常初级的简单阶段,目前只能处理一些魔兽世界和暗黑破坏神3的端点。

如何使用

  1. 使用 composer 安装包

    composer require kasperfm/neoblizzy
  2. 在你的 .env 文件中设置你的 Battle.net API 密钥和区域,如下所示示例

    BATTLENET_API_KEY=abc123
    BATTLENET_API_SECRET=secret321
    BATTLENET_LOCALE=en_GB

    如果你没有任何密钥,你可以在这里创建。

  3. 如果你想要启用或禁用 Laravel 的缓存系统来缓存 API 的结果,你也可以在 .env 文件中设置。默认情况下它是启用的,缓存时间为 120 秒。

    BATTLENET_ENABLE_CACHE=true
    BATTLENET_CACHE_TIMEOUT=120
  4. 太好了!设置已完成,现在你可以在应用程序中使用此包了。这里有一个示例,其中 Zomixiana 是我的角色名称,而 Tarren Mill 是本次的服务器/领域。

    $wowChar = \NeoBlizzy::make()->setRegion('eu')->wowApi()->getCharacterData('Zomixiana', 'Tarren Mill');
    dd($wowChar);
    
    // The result of the dd($wowChar) function.
    KasperFM\NeoBlizzy\Services\WoW\CharacterHelper {
      #name: "Zomixiana"
      #realm: "Tarren Mill"
      #gender: "Female"
      #level: 56
      #exp: 78491
      #achievementPoints: 4375
      #faction: "Horde"
      #race: "Undead"
      #class: "Mage"
      #currentSpec: "Frost"
      #avatarUrl: "https://render.worldofwarcraft.com/eu/character/tarren-mill/122/174314618-avatar.jpg"
      #characterDisplayUrl: "https://render.worldofwarcraft.com/eu/character/tarren-mill/122/174314618-main.jpg" }
    
    
    dd($wowChar->getName());
    // The result of the getName() function on the $wowChar object.
    "Zomixiana"