使用Javascript Graph API在Facebook上发布等长方形360°全景图

使用JavaScript Graph API在Facebook上发布360°全景图

基础概念

Facebook Graph API是Facebook提供的官方接口，允许开发者通过编程方式与Facebook平台交互。360°全景图是一种特殊类型的图片，允许用户在360度范围内环视场景。

实现步骤

1. 准备工作

首先需要：

一个Facebook开发者账号
创建Facebook应用并获取App ID
获取用户访问令牌(access token)并确保有publish_pages权限

2. 上传360°全景图

// 使用FormData构建请求
const formData = new FormData();
formData.append('access_token', 'YOUR_ACCESS_TOKEN');
formData.append('source', imageFile); // imageFile是File对象
formData.append('allow_spherical_photo', 'true'); // 关键参数，标记为360图片

// 发送POST请求
fetch('https://graph.facebook.com/v19.0/me/photos', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(data => {
  console.log('Photo uploaded:', data);
  // 返回的data中包含photo_id
})
.catch(error => {
  console.error('Error uploading photo:', error);
});

3. 发布到用户时间线或页面

// 如果上传到页面而不是个人资料，使用page_id代替me
fetch(`https://graph.facebook.com/v19.0/me/feed`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    access_token: 'YOUR_ACCESS_TOKEN',
    message: 'Check out this 360° panorama!',
    attached_media: `[{"media_fbid":"${photoId}"}]` // 使用上一步返回的photo_id
  })
})
.then(response => response.json())
.then(data => {
  console.log('Post published:', data);
})
.catch(error => {
  console.error('Error publishing post:', error);
});

关键注意事项

图片要求：
- 必须是等距长方形投影(equirectangular projection)
- 建议分辨率至少为6000×3000像素
- 支持JPEG或PNG格式
- 必须包含正确的EXIF元数据标记为360°图片

权限要求：
- 用户需要授予publish_pages权限(对页面)
- 或publish_to_groups权限(对群组)
- 或publish_actions权限(对个人资料)
常见问题解决：
- 上传失败：检查图片格式和元数据是否正确
- 权限错误：确保有正确的访问令牌和权限
- 图片未显示为360°：确认上传时设置了allow_spherical_photo=true