官方文档地址
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.js
import 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/76561199022526231
- steam公开个人信息功能页
https://steamcommunity.com/profiles/76561199022526231/edit/settings
- steam登录
-
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)