二維碼是常見的信息載體,廣泛應用於掃碼支付、頁面跳轉、身份識別與活動推廣等場景。在 iOS 中,自 iOS 7 起,系統本身就提供了二維碼生成與識別能力,開發者可以基於 Core Image 快速實現二維碼生成。

Core Image 提供了 CIQRCodeGenerator 濾鏡,可以根據字串生成二維碼圖像。
+ (CIImage *)createQRFromAddress:(NSString *)networkAddress {
NSData *stringData = [networkAddress dataUsingEncoding:NSUTF8StringEncoding];
CIFilter *qrFilter = [CIFilter filterWithName:@"CIQRCodeGenerator"];
[qrFilter setValue:stringData forKey:@"inputMessage"];
[qrFilter setValue:@"H" forKey:@"inputCorrectionLevel"];
return qrFilter.outputImage;
}
其中,inputCorrectionLevel 表示容錯等級,通常可以設定為 L、M、Q、H。等級越高,容錯能力越強,但圖形也會更密集。
Core Image 直接輸出的二維碼通常尺寸較小,邊緣也可能不夠清晰。為了讓掃描更穩定,可以將其放大並重新繪製成位圖。
+ (UIImage *)excludeFuzzyImageFromCIImage:(CIImage *)image size:(CGFloat)size {
CGRect extent = CGRectIntegral(image.extent);
CGFloat scale = MIN(size / CGRectGetWidth(extent), size / CGRectGetHeight(extent));
size_t width = CGRectGetWidth(extent) * scale;
size_t height = CGRectGetHeight(extent) * scale;
CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceGray();
CGContextRef bitmapRef = CGBitmapContextCreate(nil, width, height, 8, 0, colorSpace, (CGBitmapInfo)kCGImageAlphaNone);
CIContext *context = [CIContext contextWithOptions:nil];
CGImageRef bitmapImage = [context createCGImage:image fromRect:extent];
CGContextSetInterpolationQuality(bitmapRef, kCGInterpolationNone);
CGContextScaleCTM(bitmapRef, scale, scale);
CGContextDrawImage(bitmapRef, extent, bitmapImage);
CGImageRef scaledImage = CGBitmapContextCreateImage(bitmapRef);
CGContextRelease(bitmapRef);
CGImageRelease(bitmapImage);
CGColorSpaceRelease(colorSpace);
return [UIImage imageWithCGImage:scaledImage];
}
完成後,二維碼就能以更清晰的尺寸顯示。

默認生成的二維碼通常是黑白色,但在實際產品中,可能需要配合品牌色或介面風格調整顏色。實現思路是遍歷二維碼像素,將深色像素替換為自定義顏色,將接近白色的像素設為透明。
+ (void)fillWhiteToTransparentOnPixel:(uint32_t *)rgbImageBuf pixelNum:(int)pixelNum red:(NSUInteger)red green:(NSUInteger)green blue:(NSUInteger)blue {
uint32_t *pCurPtr = rgbImageBuf;
for (int i = 0; i < pixelNum; i++, pCurPtr++) {
if ((*pCurPtr & 0xffffff00) < 0xd0d0d000) {
uint8_t *ptr = (uint8_t *)pCurPtr;
ptr[3] = red;
ptr[2] = green;
ptr[1] = blue;
} else {
uint8_t *ptr = (uint8_t *)pCurPtr;
ptr[0] = 0;
}
}
}
需要注意的是,自定義顏色不宜過於接近白色,否則會影響掃描識別率。因此可以在生成前加入顏色亮度判斷。
類似微信二維碼的樣式,通常會在中心位置加入頭像或 Logo。為了讓視覺更自然,頭像通常會加上圓角與白色邊框。

實現時,可以先生成頭像的圓角版本,再將它繪製到二維碼中心。白色背景圖的尺寸通常會略大於頭像,以形成邊緣效果。
+ (UIImage *)imageOfRoundRectWithImage:(UIImage *)image size:(CGSize)size radius:(CGFloat)radius {
if (!image) {
return nil;
}
const CGFloat width = size.width;
const CGFloat height = size.height;
radius = MAX(5.f, radius);
radius = MIN(10.f, radius);
UIImage *img = image;
CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB();
CGContextRef context = CGBitmapContextCreate(NULL, width, height, 8, 4 * width, colorSpace, kCGImageAlphaPremultipliedFirst);
CGRect rect = CGRectMake(0, 0, width, height);
CGContextBeginPath(context);
addRoundRectToPath(context, rect, radius, img.CGImage);
CGImageRef imageMasked = CGBitmapContextCreateImage(context);
img = [UIImage imageWithCGImage:imageMasked];
CGContextRelease(context);
CGColorSpaceRelease(colorSpace);
CGImageRelease(imageMasked);
return img;
}
其中,圓角路徑可以透過 CGContextAddArcToPoint 或相關路徑 API 建立。核心思路是先在上下文中繪製圓角矩形路徑,再將原圖裁剪到該範圍內。
在實際項目中,建議把二維碼生成邏輯封裝到 UIImage 的分類中,並提供不同參數的方法接口。例如:
+ (UIImage *)imageOfQRFromURL:(NSString *)networkAddress codeSize:(CGFloat)codeSize red:(NSUInteger)red green:(NSUInteger)green blue:(NSUInteger)blue insertImage:(UIImage *)insertImage roundRadius:(CGFloat)roundRadius;
同時,簡單接口可以轉調完整接口,形成類似 Designated Initializer 的設計:
+ (UIImage *)imageOfQRFromURL:(NSString *)networkAddress {
return [self imageOfQRFromURL:networkAddress
codeSize:100.0f
red:0
green:0
blue:0
insertImage:nil
roundRadius:0.f];
}
透過這種方式,二維碼生成、顏色渲染、中心圖片與圓角處理都可以被統一管理,也更容易在專案中復用。