常见问题产品文档

Transcription

1 万象优图 常见问题 产品文档

2 版权声明 腾讯云版权所有 本文档著作权归腾讯云单独所有, 未经腾讯云事先书面许可, 任何主体不得以任何形式复制 修改 抄袭 传 播全部或部分本文档内容 商标声明 及其它腾讯云服务相关的商标均为腾讯云计算 ( 北京 ) 有限责任公司及其关联公司所有 本文档涉及的第三方 主体的商标, 依法由权利人所有 服务声明 本文档意在向客户介绍腾讯云全部或部分产品 服务的当时的整体概况, 部分产品 服务的内容可能有所调整 您所购买的腾讯云产品 服务的种类 服务标准等应由您与腾讯云之间的商业合同约定, 除非双方另有约定, 否则, 腾讯云对本文档内容不做任何明示或模式的承诺或保证 第 2 页共 19 页

3 文档目录 文档声明... 2 签名问题... 4 图片上传问题... 6 图片处理问题... 9 图片管理问题 版本相关问题 SDK 相关问题 RESTful API 问题 跨域问题 其他问题 第 3 页共 19 页

4 签名问题 1 删除失败,code:-73 desc: 单次签名 - 过期时间不为 0 单次签名的有效期需要设置为 0 2 如果多次使用, 就需要获取多次签名吗 单次签名是用于对某个图片进行管理操作的, 比如复制 删除 3 {"code":-70,"message":"appid/userid 与签名不匹配 "}, 是什么原因? 做签名的 url 要和最终上传的 url 一样一样的,sign 不要直接加到 query string 上 4 'code':-97 非法签名 首先确认签名时间是否超时, 是否是服务器时间不准确导致 同时查看 sign 设置的过期时间, 时间太短可能导 致大文件没有传输完就已经超时 5 注册签名内 USERID SIGN 是必填项么 USERID 是老版本内容, 现在没有意义了后续会去掉, 现在写 0 就可以了 SIGN 是必须要填的, 需要自己生成 的 6 签名经常性错误 使用 sign=xxx 方式带来的后果 需要对 xxx 进行 urlencode 7 这个 sign 不是在 FileCloudSign.appSignV2(APP_ID_V2, SECRET_ID_V2, SECRET_KEY_V2, BUCKET expired, "0", sign); 这个方法里进行过 urlencode 了吗 第 4 页共 19 页

5 如果将签名放到 header 中, 是不需要 urlencode 的 如果放到 url 中, 需要 urlencode 8 Sign 值是要自己算的吗 是的, 需要计算, 如果使用 sdk,sdk 里面会有对应的方法处理如果不使用 sdk, 请参考文档签名与鉴权文档 9 有没地方可以输入项目 ID, 空间名称 (bucket),secret ID,Secret Key 可以快速返回签名串的工具 第 5 页共 19 页

6 图片上传问题 1 上传图片的时候提示 " 回包错误! code:-1894 errdesc: 业务不存在, 请在 Qcloud 上创建 " 检测是否有填写 bucket 信息 老版本使用不变, 新创建的需要带空间名称 2 上传文件 3M 就失败了 默认是 20M 最大限制, 上传超时了 打开 SDK 代码中的 ImageV2.php, 找到 75 行改掉 10 秒超时 3 图片是否支持上传覆盖功能 没有覆盖功能, 需要删除后重新上传 4 服务器端要上传图片就必须自己写控制台 只要支持自定义 fileid 都行的, 我们提供了 sdk 支持上传等各种操作, 但是具体图片管理的控制台需要自己写 5 现在上传图片, 可以自己自定义图片 URL 吗? 就是我自定义一个 URL 地址吧图片上传上去, 然后我能通过这个指定的 URL 直接下载到这张图片 现在新的图片空间是可以的域名和域名后面的 fileid 都可以自定义 6 如果上传的话, 没有确定 fieldid, 自动生成的是 36 位吗? 目前自动生成的是 36 位 7 万象优图上传图片, 能直接上传 base64 的字节流么 支持 base64 8 上传文件时, 为什么路径是随机生成的? 第 6 页共 19 页

7 没有指定 fileid, 就是会自动生成一个 9 上传同一个文件, 我需要在地址后面加入随机参数, 以便他及时刷新 防止浏览器缓存吗? 可以拿修改时间当随机串 10 上传文件失败,code:-177 desc:cos: 文件已存在 这个是重复上传的提示, 后续会做成如果上传重复将直接返回下载 URL 11 {"code":-5989,"message":" 上传失败 "} 一般是属于文件落地超时导致 12 万象支持直传吗? 不想先上传到我的服务器再传到万象 通过 form 直接上传不行的, 因为需要一个鉴权的过程 可以通过 form 将图片传到你自己的业务服务器, 再由 服务器端程序调用 php sdk 参考示例 13 web 客户端上传图片, 是否必须通过服务器端呢 上传需要鉴权, 客户端从鉴权服务器获取到签名, 就可以开始上传了, 拿到签名后这时的上传可以不通过服务 器, 这样就是安全不暴露 key 的了 14 java sdk, 上传图片时报错 upload pic error, error=errno=-1 desc=url exception, e=java.io.ioexception: Server returned HTTP response code: 400 for URL: 签名错了, 检查下签名 15 "code":-166,"message":" 索引不存在 " 第 7 页共 19 页

8 检查上传路径是否错误, 文件夹是否存在, 不存在需要创建 第 8 页共 19 页

9 图片处理问题 1 控制台上面设置的样式和样式下载别名有什么区别? 控制台上面设置的空间样式和样式下载别名是预处理和实时处理的区别 控制台上面设置的空间样式 : 图片上传存储时, 会针对开发者设置的空间样式生成一份样式图, 即会存储原图和样式图两种图片 ( 如果开发者设置多个样式, 对针对每种样式都会生成一份相应的样式图 ); 样式下载别名 : 本质是实时处理功能, 给一组实时处理参数起个简单的别名, 利用别名去实现相应的实时处理功能 由于样式下载别名是实时处理, 其访问速度相对于空间样式会稍微慢一点 2 上传 5M 的图片, 万象里面会保存这个 5M 的图片吗? 还是上传的时候就自动处理压缩了, 然后上传到万象是压缩后的图片呢 是在保存原图的时候, 再生成一个对应的缩略图一并保存 3 webp 压缩是在云端做吧, 终端 webp 加载是需要调用 SDK 才能加载出来么? 对的, 云端做 webp 压缩, 终端可以用我们的 sdk 显示 webp 4 关于水印功能, 上传到云上就带着水印吧 例如开发者设置了水印样式, 腾讯云会存两份图, 一份是原图, 一份是根据样式生成的效果图 5 是否支持图片质量控制 支持在控制台可以设置 6 可不可以万象优图只作处理, 图片还是在本地呢 图片上传到万象优图, 处理后, 下载到本地就是了 7 在图片空间设置了空间样式, 为什么上传的图片没有图片水印的效果 第 9 页共 19 页

10 把 /original 替换成 /thumb 8 public int food 是什么意思 这个是图片识别的场景,food 是能识别美食 9 缩略图无法下载 需要空间先创建样式, 之后上传的图 下载时可以用缩略图的, 检查下图片是在创建样式之前传的 第 10 页共 19 页

11 图片管理问题 1 源服务器图片更改, 名称不变, 怎么刷新 cdn 的相同名称的图片 会自动更新的, 不需要用户刷新 2 想在空间下创建目录, 怎么创建呢 不用建目录, 目录的概念体现在 fileid 这个文件名里, 比如要往 a 目录下传文件 abc.jpg, 把 fileid 设为 a/abc.jpg 即可 3 开了 token 防盗链, 白名单里面的网站也需要用签名么 白名单里的就不需要签名了 4 设置了域名仿盗链, 白名单里设置了我的域名为什么打开显示此图片未经允许不可使用 设置了域名防盗链, 需要在访问下载 url 的时候加上 refer 5 网站的图片该如何储存到万象优图又该如何调用这些图片呢 我们有提供 sdk, 可以使用我们的 sdk 通过代码上传图片, 上传后会返回图片的 url 地址, 用这 url 就可以直接访问 6 业务不存在, 请在 qloucd 上创建 检查配置文件是否都写正确了 7 下载地址为什么不是以文件名结尾了 空间设置为私密的, 所以访问的 url 加签名了 8 图片删除, 多久生效 第 11 页共 19 页

12 万象优图的存储上是立即生效的,cdn 需要 15 分钟刷新 第 12 页共 19 页

13 版本相关问题 1 腾讯云 万象优图 V1 V2 和 V2 加强版的区别有哪些? 下面从功能 Restful API 上传接口 下载 url 等几个方面对三个版本的区别进行说明 功能 : V1 版本 : 万象优图第一个版本, 无 bucket 概念, 控制台创建的是应用 ; V2 版本 : 万象优图第二个版本, 首次提出 bucket 概念 ; V2 加强版 : 万象优图第三个版本, 有 bucket 概念, 采用新的实时处理风格,fileid 支持特殊字符, 支持回源镜像 样式下载别名 样式分隔符 注 : 1 相应的功能请参考图片空间-> 管理和样式, 以及相应的 wiki 说明 2 A 风格和 B 风格实时处理请分别参考 A 风格实时处理文档和 B 风格实时处理文档 3 下表中" " 表示支持," " 表示不支持 ; 4 fileid( 特殊字符 ) 表示是否支持自定 fileid 功能 V1 版本 V2 版本 V2 加强版 自定义 fileid fileid 包含特殊字符 控制台图片样式 图片空间 (bucket) A 风格实时处理 B 风格实时处理 样式下载别名 -A 风格 样式下载别名 -B 风格 样式分隔符 镜像回源 USERID 后台置 0 处理 后台置 0 处理 APPID 含义 应用名称 项目名称 项目名称 Restful API 上传接口 : 版本上传接口 fileid 说明 V1 版本 可选, 由字母, 数字, -, photos/v1/[appid]/[userid]/[fileid _ 等字符组成, 最长 128 字节 第 13 页共 19 页

14 版本上传接口 fileid 说明 ] V2 版本 可选, 由字母, 数字, -, photos/v2/[appid]/[bucket]/[useri等字符组成, 最长 128 字节 d]/[fileid] V2 加强版本 可选, 由除了 \0 外的任意字符组成, photos/v2/[appid]/[bucket]/[useri需要对 fileid 进行 urlencode, 最长 1 d]/[fileid] 28 字节 下载 url: 版本 V1 版本 下载 url d]/[fileid]/original V2 版本 ket]-[appid]/[userid]/[fileid]/orignal V2 加强版本 d] 注 : 1 表中的下载 url 为原图的下载 url 2 V1 和 V2 版本访问相应的样式图只需要将下载 url 中的 "original" 改成开发者设置的样式名即可 3 V2 加强版访问相应的样式图方法为 : 下载 url+ 样式分隔符 + 样式名 2 万象优图在用 v1 版本有必要升级到 v2 加强版吗 上面有三个版本的区别说明 可以自行判断一下 3 使用 V1 和 V2 有多大的影响 v1 跟 v2 是一样的, 只不过就是 v1 对应的是应用,v2 对应的是空间, 只是在接口使用上传递的参数不太一样 第 14 页共 19 页

15 SDK 相关问题 1. Android 相关问题 1.1 为什么 Android Studio 导入 Demo 后运行无法上传, 会输出日志!isLibraryPrepared? 版本 之前的 Demo 是使用 Eclipse 开发的, 使用 Android Studio 导入时不会自动添加 so, 需要手动导入 可以在 Android Studio 的项目配置文件中加入如下配置 : sourcesets { main { jnilibs.srcdirs = ['libs'] } } 1.2 上传失败,Log 显示异常 ClassNotFoundException 项目使用了代码混淆功能将 SDK 的代码进行了混淆, 上传 SDK 有些类被混淆之后会导致异常而上传失败 需要 将下面的配置加入到项目的混淆配置中 : -keep class com.tencent.upload.network.base.connectionimpl -keep class com.tencent.upload.network.base.connectionimpl {*;} -keep class * extends com.qq.taf.jce.jcestruct { *; } 2. ios 相关问题 2.1 调用 SDK 上传 API 返回错误码 -97, 比如日志里有 :upload return=-97 表示使用的签名是非法的 可以调用 UploadManager 的 validatesignature 判断签名是否合法, 目前图片云的签名后台升级, 增加了 bucket 信息 第 15 页共 19 页

16 2.1 调用 SDK 提供的 API 返回错误码 -80 表示使用的业务 ID 是非法的 需要使用在腾讯云控制台应用管理上注册 APP 时得到的 AppID 2.3 调用 SDK 提供的 API 返回错误码 -79 表示使用的 SecretID 不存在 需要使用在腾讯云控制台应用管理上注册 APP 时得到的 SecretID 2.4 调用 SDK 提供的 API 返回错误码 -182 表示参数错误 必填参数不能为空或者不合法, 需要校验 2.5 图片云 / 文件云的写操作, 比如删除和更新, 需要传入单次签名信息, 操作 API 返回 -73 表示单次签名的过期时间 expired 不为 0 生成单次签名时必须将过期时间 expired 设置为 0 第 16 页共 19 页

17 RESTful API 问题 1 云图上传下载接口每天的调用次数有没有限制 没有限制 2 js 跨域访问失败 请不要使用 header 添加 authorization 的方式, 会出现跨域访问限制 使用 url?sign=xxx 的方式可以解决问题 3 token 防盗链下载时, 签名经常性错误 token 防盗链下载图片的方式为 url?sign=xxx, 需要对签名 xxx 进行 urlencode 第 17 页共 19 页

18 跨域问题 1 以下错误是跨域问题么 No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin ' is therefore not allowed access. js 调用时, 有跨域问题的, 抓包看看是否是 OPTIONS 请求目前服务器端不支持 options 请求, 需要避免浏览器发送 options 请求 怎样避免? 对于跨域, 简单请求时, 浏览器是不会发送 options 请求的 只使用 GET, HEAD 或者 POST 请求方法 如果使用 POST 向服务器端传送数据, 则数据类型 (Content-Type) 只能是 application/x-www-form-urlencoded, multipart/form-data 或 text/plain 中的一种 不会使用自定义请求头 ( 类似于 X-Modified) 2 js 跨域访问失败 不要使用 header 添加 authorization 的方式, 会出现跨域访问限制 换用 url?sign=xxx 的方式 3 使用的 Huploadify 上传插件, 要怎样跨域请求, 用 Picasso 直接下载怎么下载不了 Huploadify 插件, 看请求, 只要发出的是简单请求就能够跨域 第 18 页共 19 页

19 Powered by TCPDF ( 常见问题产品文档 其他问题 1 当月免费的流量 50G 用完了, 账户里没钱文件还能下载吗 50G 是免费的流量, 超过 50G 就开始阶梯计费了 结算是每个月 1 号到 5 号结算上个月的使用费用, 一直不缴费 会有邮件以及短信提醒, 在提醒的最后截止日期内未交费会冻结账号 2 腾讯云服务器和万象之间, 算内网吗 不是, 目前还没开放内网的 API 3 javasdk 为什么我的控制台输出的是乱码呢 将 request 返回改成 utf-8 4 如果我使用万象图片的 SDK( 终端 ), 视频和语音能上传下载么 万象图片不支持非图片的文件 cos 可以存储任何类型的文件 第 19 页共 19 页