H5接入Steam 获取用户数据案例 使用 OpenID 登录绑定公司APP账户 steam公开用户信息获取 steam webapi文档使用

官方文档地址

1.注册 Steam API Key：

你需要一个 Steam Web API Key，可以在 Steam API Key 页面 获取。https://steamcommunity.com/dev/apikey
这里开发做demo用自己steam账户的就好，后续上线要用公司的账户

2.使用 OpenID 登录：

实现 Steam OpenID 登录，以便用户通过 Steam 账户登录你的应用。
例如网易Buff的登录，带参跳转到steam登录页，登陆成功后steam会自动回调并返回用户数据
这一步可以后台对接OpenID 给一个完整的登陆链接，H5负责跳转该链接登录、响应steam回调和绑定检测等

https://steamcommunity.com/openid/login?openid.ns=【openid.ns】&openid.mode=【openid.mode】&openid.return_to=【openid.return_to】&openid.realm=【openid.realm】&openid.identity=【openid.identity】&openid.claimed_id=【openid.claimed_id】

openid.ns //这个参数指定OpenID协议的命名空间（Namespace），它是用来确定OpenID协议版本的。例如，openid.ns=http://specs.openid.net/auth/2.0 表示使用的是OpenID 2.0协议。openid.mode 这个参数指示OpenID提供商（Provider）应执行的操作类型。常见的模式包括： checkid_setup: 请求OpenID认证（用户可能需要手动确认）。checkid_immediate: 请求OpenID认证，但不需要用户干预，适用于自动登录场景。id_res: OpenID认证成功后的响应模式。cancel: 用户取消了认证过程。setup_needed: 用户需要设置其OpenID标识。failure: OpenID认证失败。 openid.return_to 这个参数指定OpenID认证完成后返回的URL地址。当认证过程结束时，用户会被重定向回这个URL。openid.realm 这个参数指定了依赖方（Relying Party）的应用范围或信任域。它通常与用户的登录会话相关联，表明哪些站点被认为是可信的。openid.identity 这个参数包含了用户希望使用的OpenID标识符。如果用户没有明确提供一个标识符，那么这个值可能会指向用户的默认OpenID提供商。openid.claimed_id 这个参数表示用户声称拥有的OpenID标识符。它通常是用户提供的URL，指向他们的OpenID标识。如果用户提供了openid.identity，则openid.claimed_id通常是指定的标识符。

3.获取玩家数据：

使用 GetPlayerSummaries 方法获取玩家信息。

https://api.steampowered.com/ISteamUser/GetPlayerSummaries/v2/?key=YOUR_API_KEY&steamids=STEAM_ID

4.创建API服务：

// src/api.jsimport axios from 'axios';const API_KEY = 'YOUR_API_KEY';const BASE_URL = 'https://api.steampowered.com';export const getPlayerData = async (steamId) => {  try {    const response = await axios.get(`${BASE_URL}/ISteamUser/GetPlayerSummaries/v2/`, {      params: {        key: API_KEY,        steamids: steamId,      },    });    return response.data.response.players[0];  } catch (error) {    console.error('Error fetching player data:', error);    throw error;  }};

5.组件内调用：

<template>  <div v-if="player">    <h1>{{ player.personaname }}</h1>    <img :src="player.avatar" alt="Avatar">  </div>  <div v-else>    Loading...  </div></template><script>import { ref, onMounted } from 'vue';import { getPlayerData } from './api';export default {  setup() {    const player = ref(null);    onMounted(async () => {      try {        player.value = await getPlayerData('STEAM_ID');      } catch (error) {        console.error(error);      }    });    return { player };  },};</script>

6.接口返回
以我自己的steami【76561199022526231】为例：

页面

steam登录 https://steamcommunity.com/login/home/?goto=steam登录后个人信息页：https://steamcommunity.com/profiles/76561199022526231steam公开个人信息功能页 https://steamcommunity.com/profiles/76561199022526231/edit/settings

API

主动获取他人资料的官方：https://api.steampowered.com/ISteamUser/GetPlayerSummaries/v2/?key=【Steamworks Web API 】&steamids=76561199022526231

steamid - 用户64位ID

communityvisibilitystate - int型，资料可见模式 1 = 隐私 2 = 仅好友可见 3 = 用户好友的好友也可见 4 = 只对登录Steam的用户可见 5 = 公开，任何人可见

profilestate - 如果为1，该用户填写了自己的资料

personaname - 用户昵称

lastlogoff - unix时间格式，上次在线时间

profileurl - 用户Steam社区资料地址

avatar - 32*32图像

avatarmedium - 64*64图像

avatarfull - 184*184图像

personastate - 用户状态 0 - 不在线 （如果资料为隐私也是如此） 1 - 在线 2 - 忙碌 3 - 离开 4 - 休息？Snooze 5 - 寻找交易中 6 - 寻找游戏中

commentpermission - 如果出现，代表任何人都可以评论

realname - 真实姓名

timecreated - UNIX时间形式，建号？（the profile was created）时间

loccountrycode - ISO 3166 代码，用户所在国家

locstatecode - 可变代码长度，用户所在州

loccityid - 一串INT型Steam内部ID，代表所在城市

gameid - 如果用户在游戏中，这会是以String形式的游戏APP ID（DOTA2是570）