为了不让别人盗取资源盗的那么爽，我们有时候需要对图片／视频添加水印，也有可能对视频进行一些转码，这在七牛云中都比较容易实现。

在七牛云上传文件之前，是需要先进行一些配置的，如配置scope，上传token的截至时间deadline，返回的数据returnBody，回调地址callbackUrl等等，图片水印设置需要设置persistentOps 和persistentPipeline。

1. {

2. 
   

3. "scope":               "<Bucket                   string>",

4. "deadline":            "<UnixTimestamp            uint32>",

5. "insertOnly":          "<AllowFileUpdating        int>",

6. 
   

7. "endUser":             "<EndUserId                string>",

8. 
   

9. "returnUrl":           "<RedirectURL              string>",

10. "returnBody":          "<ResponseBodyForAppClient string>",

11. 
    

12. "callbackUrl":         "<RequestUrlForAppServer   string>",

13. "callbackHost":        "<RequestHostForAppServer  string>",

14. "callbackBody":        "<RequestBodyForAppServer  string>",

15. "callbackBodyType":    "<RequestBodyTypeForAppServer  string>",

16. "callbackFetchKey":    "<RequestKeyForApp         int>",

17. 
    

18. "persistentOps":       "<persistentOpsCmds        string>",

19. "persistentNotifyUrl": "<persistentNotifyUrl      string>",

20. "persistentPipeline":  "<persistentPipeline       string>",

21. "saveKey":             "<SaveKey                  string>",

22. "fsizeMin":            "<FileSizeMin              int64>",

23. "fsizeLimit":          "<FileSizeLimit            int64>",

24. 
    

25. "detectMime":          "<AutoDetectMimeType       int>",

26. 
    

27. "mimeLimit":           "<MimeLimit                string>",

28. "deleteAfterDays":     "<deleteAfterDays          int>",

29. "fileType":           "<fileType                  int>"

30. }

persistentOps 

• 资源上传成功后触发执行的预转持久化处理指令列表。每个指令是一个 API 规格字符串，多个指令用;分隔。

• 实际就是指定文件上传成功后，还需要做什么，比如添加水印／视频转码

• 格式为 指令1;指令2;....;指令n|saveas/要保存的地址

• 具体的指令格式稍后再看

• 要保存的地址：对"bucket:key"进行URL安全的Base64编码，bucket是你的存储空间名称，key是要保存的文件名，两个用冒号链接，然后进行URL安全的Base64编码

  
  

添加水印指令

七牛分图片水印和文字水印

图片水印命令

1. watermark/1

2. /image/<encodedImageURL>

3. /dissolve/<dissolve>

4. /gravity/<gravity>

5. /dx/<distanceX>

6. /dy/<distanceY>

7. /ws/<watermarkScale>

水印锚点参数表

1. |  NorthWest     |     North      |     NorthEast

2. |                |

3. |                |

4. -----------------+----------------+--------------

5. |                |

6. |  West          |     Center     |          East

7. |                |

8. -----------------+----------------+--------------

9. |                |

10. |                |

11. |  SouthWest     |     South      |     SouthEast

文字水印可选指令：

1. watermark/2

2. /text/<encodedText>

3. /font/<encodedFontName>

4. /fontsize/<fontSize>

5. /fill/<encodedTextColor>

6. /dissolve/<dissolve>

7. /gravity/<gravity>

8. /dx/<distanceX>

9. /dy/<distanceY>

persistentPipeline

• 转码队列名。资源上传成功后，触发转码时指定独立的队列进行转码。为空则表示使用公用队列，处理速度比较慢

这样就很明白了，通过persistentOps设置进行哪些指令，通过persistentPipeline设置通过那个队列来执行这些指令。

添加文字水印范例核心代码（php－YII框架）

$policy=[

    "persistentOps"=> "watermark/2/text/".\Qiniu\base64_urlSafeEncode("珊瑚学院")."/dissolve/30|saveas/".\Qiniu\base64_urlSafeEncode($bucket.":$(key)") ,
    "persistentPipeline"=>"",
          
];

• watermark/2/text/".\Qiniu\base64_urlSafeEncode("珊瑚学院")：可以参考上面文字水印的指令，可以看出这条语句的意思是，添加一个文字水印，内容为“珊瑚学院”，内容必须进行url安全的base64编码

• /dissolve/30：设置文字水印透明度为30

• |saveas/".\Qiniu\base64_urlSafeEncode($bucket.":$(key)")  ：图片打完水印后保存到指定的bucket中，文件名称为key，保存路径需要进行url安全的base64编码

• persistentPipeline"=>""，设置persistentPipeline为空，指明使用公用队列

视频转码

视频相关可用指令

1. avthumb/<Format>

2. /ab/<BitRate>

3. /aq/<AudioQuality>

4. /ar/<SamplingRate>

5. /r/<FrameRate>

6. /vb/<VideoBitRate>

7. /vcodec/<VideoCodec>

8. /acodec/<AudioCodec>

9. /scodec/<SubtitleCodec>

10. /subtitle/<SubtitleURL>

11. /ss/<SeekStart>

12. /t/<Duration>

13. /s/<Resolution>

14. /autoscale/<Autoscale>

15. /aspect/<Aspect>

16. /stripmeta/<StripMeta>

17. /h264Crf/<H264Crf>

18. /rotate/<Degree>

19. /wmImage/<EncodedRemoteImageUrl>

20. /wmGravity/<Gravity>

21. /wmText/<text>

22. /wmGravityText/<gravity_text>

23. /wmFont/<font>

24. /wmFontColor/<fontcolor>

25. /wmFontSize/<fontsize>

26. /writeXing/<Xing>

27. /an/<AudioNo>

28. /vn/<VideoNo>

29. /sn/<SubtitleNo>

假如我们想让视频上传后都转为mp4格式，则可以进行如下设置

"persistentOps"=> "avthumb/mp4|saveas/".\Qiniu\base64_urlSafeEncode($bucket.":$(key)") ,
"persistentPipeline"=>"",

参考资料：七牛上传策略